
For Macintosh Programmers & Developers 


0 3212874887 8 


Includes Special 


Section by Apple Co nip liter, Inc 


UILDIIUC A 


— 

APPLICATION 

WITH 

JavaBeans 


ActiveX 

controls 

FOR 

MACINTOSH 


$5.85 US 
$6.95 Canada 
ISSN 1067-8360 
Printed in U.S.A. 





































Visual Java Development 


► 

Build Rome in a day. 

It's easy with Symantec 
Visual Cafe" 1 for Java: 




“ mi® Develop faster Compile 
1 ^ ster Debug faster. Realize 
i your Java ,w dreams faster, 

Symantec, the creator of 
:he first full featured Java 
development environment, now unleashes 
the first Rapid Application Development 
environment for Java developers: 

Symantec Visual Caf6.™ 

Visual Cafe comes complete with an 
extensible component library with all of the 
building blocks you need for your application* 

Simply drag and drop a component 
onto a form. Our Interaction Wizard 
lets you visually specify all the actions 
and events. And then Visual Cafe 
automatically generates the Java 
code for you. 

Thanks to our exclusive two-way 
programming you can add or modify 
the code at the source level, too. 

So you’ll be whipping out those 
application prototypes at speeds 
you can only dream of now 

Imagine building all of your forms 
visually. Or building your entire user interface 
without writing one single line of code! 

As an added bonus. Symantec's Just In 
Time (JfT) compiler (included in Netscape's 
new Navigator 11 ') runs your Java applications 
faster than any other browser or Java 
virtual machine on the planet. 

So get your hands on the hottest new 
development tool for Java right away. 

For more information, call us at 
1-80Q-453 4059 ext. 9H29 or visit our 
Web site at cafe.symantec.com. Or 
pick up a copy at Fry’s, MicroCenter, 
CompUSA or Egghead. 
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aligned to* 



Microsoft* 


SYMANTEC. 


Symantec ib a reyteieretf trademmiL arid Visual CuM is a trademark of Symantec Corporation. Java Is a trademark of Sun Mtoosyfftefts. he. Microsoft, Windows find (he Windows logo aio 
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Behind every good Mac app.. 


Every job requires the proper tool. When it 
comes to crafting good code, BBEdit 4.0 is 
the Swiss Army Chainsaw of text editors 


"If you have to spend time with text 
on the Mac, you should use BBedit." 

— MacWeek, September 30,1996 


• Compare source fifes and 

apply differences 

• Open From and Save To FTP 

• Search and replace multiple files 
using Grep 

• Navigate source files with integrated 

PopupFuncs™ technology 

■ Browse project documenls 




tkjngie Software s Marathon Infinity, created using BBEdit 



Source cade frorn Mararttion Infinity displayed in BBEdit 


...is a great 
text editor. 



BBEdit 4.0 


BSeUser 




http://www.barebones.com/chainsaw 

To order, call 617-778-3100 



Bare Bones Software. Inc. 

BO. Bu* 1048, Bedford. MA 01730 * main 617-778-3100 * fax 617-77^3111 


liUtedit is a trademark oi Hat* Ftorira Software, Int. All other trademark* utnl reKudvrrct trademark* are ins t>f their respective Holders ft |W? Pan' Iftmr* Software, Ire 
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By Eric Gundrum 



Some Things Were not Meant to be 

This past month I Ilave grown to sympathize with many 
developers feeling abandoned, espec ially those wlio committed to 
OpenDoc Apple built a lot of excitement around that technology, 
only to pull the rug out from under the developers. OpcnDoe 
developers arc not alone in this; GX and Game Sprockets developers 
got similar treatment, as did PowerTalk folks a year ago. At least now 
Apple is vigorously pushing the rug back for Game .Spnrx kets. It’s 
those unfortunate OpenDoc folks, whoVe been trying so liard and 
building some cool products, that I Feel the most lor. This time they got 
the short end of the stick as our industry changes, bur looking to the 
future reveals many interesting opportunities. 

Producing MacTech Ls a lot like producing a software product. 
As new technology comes along, we incorporate it into our nexi 
version. We have the curse, and the benefit, of having to ship a new 
version every month. Last month Apple pulled the rug out from 
under us t too. With this Issue's ft Kits on Component Technologies, we 
had planned heavy OpcnDoe coverage. As the issue was going lo 
production, OpcnDoe was canceled and our lead w riter lost his day 
job. As you might imagine, that threw a wrench in the works. 

We really got kicky with the timing. Another week anti we 
wouldn't have been able to change this issue. Then Apple's 
analysis of how to best deliver information opened a golden 
opportunity' a partnership with develop. That partnership helps us 
to deliver many more pages of editorial content to you, and that 
new content is developed with direct participation from Apple. We 
ill ink everyone will lie pleased with this development, develop 
even gave us a finished OpcnDoe article, fitting nicely into our 
Component Technologies issue. 

But what are those unfortunate OpenDoc developers to do, now 
that their “OS* has last its champion? Many of them are still trying to 
figure tliat out. Java seems to lx* the most likely new direction. Java is 
by no means a replacement for OpenDoc; it Is very different 
technology. However, Java is Apple's ‘next big thing," garnering 
much support among the Rliapsody development team. It makes 
sense for developers to Ixgin paying more attent ion to Java, as you 
will see in this months Building Beam article, as well as in our 
upcoming Jam issue. 

It also makes sense for OpenDoc, in fad, for all developers to 
look carefully at Rhapsody. NeXT has developed some powerful 
technologies. Look at the dynamic binding of the runtime model, for 
instance, and how it is used in Interface Builder, this month's 
Object Ware article presents the component model of NEXTSTEP, 
which certainly supports at least a few of the features we liked so 
much in OpenDoc. 'Ihe dase connection between Objective-C and 
Java, and the multi platform supjxrrt of OpenStep suggest many new 
opportunities will Ixrgin to arrive once lthaps*xly ships. 


A Word About Schedules 

Occasionally I find myself explaining to readers how MacTech 
schedules articles. Before 1 Itegan as Editor-in-chief, 1 never fully 
appreciated the problems with magazine lead times, I thought I’d 
share some of the details with you so you might better understand 
how we ch<x>se content for you to read. 

The first stage in the entire process Ls choosing topics for 
MaeTech's cover. This typically happens five to ten months prior to 
the cover date to give everyone time to prepare for the issue. That Ls 
my Lime to figure out what interesting technologies are in 
development and who is the I xst person to write about them. 

We begin writing most articles anti columns for MacTech 
approximately four months before ihe date on the cover. Some 
exceptions include these Viewpoints, NewsBits and occasionally 
an article that comes in late because of the timeliness of the 
content. We can handle one late article written only three months 
before the cover date. 

You might think four months is a long time, and it is in our 
industry, but this is the reality of publishing a magazine. It breaks 
down like this: 

The ITS. Postal service requires at least two weeks lor delivery, 
and the magazine typically ships the first week of the month prior 
to the cover date. That puts it in your mailbox and on newsstands 
around the third week of the month. Before that, we need several 
weeks to take the magazine from electronic copy to film and from 
film to paper. Believe it or not, tlx* printer actually lias to schedule 
time lo print tlx* pages and for them to dry. Tliat accounts for the 
last eight weeks. Just before dial is w hen we write NewsBits and 
Viewpoint, 

There is another month in the process to edit the content and 
lay it out with ads and the table of contents. Included in that 
month are several review cycles to make the presentation of the 
content as professional-looking as we can in the time allotted. 
That Lakes us back to three months prior to shipping (when that 
late article is slipped in). The fourth month is allocated to the 
authors so they can prepare their content. Another few months to 
selec t topics and find authors brings us back to choosing the cover 
topics five to ten months prior to the cover date. 

As you can see from UiLs schedule, we have to plan very far in 
advance. Ti is a lot like shipping a new prtxiuct every month. Each 
version must contain enough new features to entice tlx* reader We go 
to some effort to hide as much of tills lead time as possible from you, 
die reader. However, our industry' is changing rapidly, and we are all 
scrambling to keep up. In fact, we developed die MacTech Now well 
site lo address this. 'Ihere you can find much of the late breaking 
industry news. Then a few months later, you Gin see the technology in 
action as the* magazine is delivered to your door D 
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MORE DEVELOPERS PROTECT. 



_ ^ ■ 


MacHASP Packs 
More Into Less. 

Based on state-of-the-art ASIC technology, 
MacHASP packs die industry’s most 
advanced security, compatibility and 
flexibility into a compact and end-user- 
friendly dongle. 

Grow With Aladdin! 

The fastest growing company 
in the industry, with over 4 
million keys sold to 20 
diuusand developed 
worldwide, Aladdin is setting 
the standard for software security today. 





NSTL Study Rates 
HASP No.1! 

A recent test conducted by die National 
Software 'listing Labs 5 , die world’s tbremosl 
independent lab, compared die flagship PC 
products of leading software protection 
vendros. Hie result? IIASP was rated the clear 
overall winner - and number one in all the 
major comparison categories. For a fiill copy 
of die NSTL report, contact your local 
HASP distributor. 


MacHASP 
PROTECTS 
MORE. ■ 


Macros 

These days, more and more developers are choosing to protect their software against 
piracy. They're protecting more products, on more platforms, with better protection - 
and selling more as a result. 

And more of these developers are protecting with MacHASP. Why? 

Because MacHASP offers more security, more reliability and more 
features than any other product on the market. Only MacHASP offers 
capabilities such as network support, anti-debugging envelope 
protection, and secure remote activation and updating. 

MacHASP supports the most advanced platforms, including all 
versions of MacOS and Power Mac - as well as AppleTalk 
networks. And because Aladdin is a licensed Apple Partner, 

MacHASP guarantees full, transparent compatibility 
with the ADB standard. 

To leant more about how you can protect 
better and sell more - call now to order 
your MacHASP Developer’s Kit. 



/fir MacHASP Dtttviaper's Kit contains 
nmr) thing you ami tofwoted your 
sofheart 1 iikkty* 


1 - 800 - 223-4277 

www.aks.com 


North America Aladdin Knowledge Systems Inc. Td: im) 1>\ 4277, 21156 4 5678, Yxr. 2U W 3J77, R mail: 
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Filling in Some of the 


Last month, we learned most of the 
syntax of the Objective-C language. Since 
then, 1 have been scorching the e-mail, 
newsgroups, and phone lines trying to 
learn more. Much thanks to Michael 
Rutman, David Klingler, Bob McBeth, and 
Eric Gundrum for their time and energies 
in trying to get me on the straight and 
narrow; As always, the good stuff is theirs, 
the mistakes, mine. 

©PRIVATE, ©PUBUC, AND ©PROTECTED 

For me, much of the Objective-C 
learning process involves learning Lhe 
differences between C++ and Objective-C 
For example. C++ allows you to use the 
access specifiers public:, private:, and 
protected: 10 define Lhe scope of a classes 1 
data members and member functions. 
Objective-C offers a similar mechanism you 
can use to specify the scope of a classes' 
instance variables (methods are always 
public): the compiler directives ©private, 
©public, and ©protected. 

! Iere's the official description of each 
of these compiler directives: 

©private — the instance variable is 
accessible only within the class that 
declares it. 

©protected — The instance variable is 
accessible within the class that declares 
it and within classes that inherit it. 
©public — The instance variable is 
accessible everywhere. 

instance variables default to 
©protected, which makes sense. After all, 
if you mark an instance variable as 
©public, that would defeat the whole point 
of data encapsulation. The point is, you 
want to force access to your instance 
variables to occur via one of your classes' 
methods, So just forget about the ©public 
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Objective-C Pieces 


compiler directive. The default .setting of ©protected will serve 
you in the vast majority of cases. 

The ©private directive does have its place, though. You 
would use ©private if you don’t want the instance variable 
inherited by subclasses. Perhaps you don't want a subclass 
monkeying with a variable that is key to the architecture of the 
base class. Or perhaps you want to minimize the dependencies 
between the base and sub classes. Though ©private does have its 
place, don’t use it unless you absolutely have a reason to. The 
general opinion seems to hold that you should never use ©private 
at all — that ail classes should have all functionality ovemdable. 
just wanted to make sure you heard both sides. 

Here’s an example that uses all three directives: 


Sinterface Employee : Object 
( 


char 

‘name: 

(^private 


Int 

yeeraWl thCompany : 

int 

hoursVaca Lion; 

@p rejected 

char 

•title: 

^public 


id 
i d 

supervisor : 
off i ceMate ; 


The ©public, ©private, and ©protected compiler directives 
hold true for all instance variables that follow until either the 
end of the class or another directive is encountered. In Lhe 
example above, the name variable is ©protected, since it is not 
marked otherwise, years WithCompany and hours Vacation are 
©private, title is protected, and supervisor and office Mate are 
public. Of course, this sample was just to show you how this 
works and is not intended as realistic code. 

Bottom line, your best bet is to leave rhese directives out of 
your code and just use the default setting of ©protected. On the 
other hand, it is worth knowing how this works so you can read 
sample code that uses it and so you can use ©private if you find 
a case where it makes sense. 

Visit MacTech® Magazine’s Web site! 

http://www.mactech.com | 
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WITHOUT US THEY 
WOULDN'T EXIST 
(OR AT LEAST THEY'D 
BE MUCK MORE 
FRUSTRATED.! 
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Digital Equipment 
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GE Information Systems 
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Macromedia 


National Geographic 

Now Software 
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GONSIDEft the possibilities. They're 
wide open- Simply put, OpenPaige" can 
do anything you want to the text of your 
software application. 

Across platforms, across architectures, 
even UNIX \ OpenPaige is a feature-rich 
text environment. Every aspect of text and 
layout formatting, editing and display is 
possible. Stylized text. Scaling. Container 
and non-rectangular shapes. Style sheet 
support. Cut, copy and paste. Embedded 
pictures, objects, buttons and even calls to 
other applications are at your fingertips. 

Don't waste time struggling with your 
text. We've already done the work for you. 
Drop in OpenPaige and go. Use as much or 


as little of it as you wish. Available as 
object code or as source code, it has 
an elegantly small footprint. Yet it will 
empower you to open doors, boundaries, 
and minds with your software application. 

But don't take our word for it. Check 
out our extensive and diverse client list. 
They've all discovered how the robust and 
flexible power of OpenPaige can open up 
entire new worlds of possibilities. 


Seagate Software 

m 

US West 

Xerox 


Open . 

Paige 


Datapak 


For additional information, check out our web site at www.datapak.com/-datiijrak/ or call us> at l-889-327-6703. 


Copyright ©1997 Datapak Software. Paige and OpenPaige are Iraderoarkj of Datepak Software. Alt brand or product names are Iradomarks or registered trademarks of trteirrespective holders 
Datapak Software 11815 NE 99th Street. Suits 1200. Vancouver. WA 96662 * Phone: 360 091.0542 ♦ Fa*: 360 691.0743 • E mail, sales^datapak.com 








Init vs. Init: 

In Last month's column, we looked at a sample program lhai 
included a simple class named Number. Here's the Number 
implementation: 

^import "Number.b* 

@implementation Number 

- inJt:(int)fltart Value /* This is BAD FORM - sec below */ 

I 

[super init]} 

value “ starLValue; 

return self; 

I 

squaxcSelf 

I 

value <= value; 

return self; 

J 

print 

I 

prinlff "Number value: XdW*, value ); 

return self; 

J 

Send 

The Number class includes a method named init: which 
takes a single parameter* As it turns out, calling an initialization 
method init when it takes a parameter is a bad thing. The name 
init should be reserved for initialization methods with no 
parameters. Imagine if you had two different classes, each of 
which declared an init: method, one of which took a float, and 
one of which Look an int as a parameter. Now imagine you had 
two object pointers, each declared as an id, one pointing to an 
object of one class, the second pointing to an object of the 
second class. If you send an init: method to one of these objects, 
tlie fact that both init: methods have the same mime and yet take 
different parameter types will cause confusion and potential bad 
behavior. The name of your initialization method is what sets it 
apart from others. You’ll see examples of this throughout the 
remainder of this column. 

In the simplest case, an initialization method with no 
parameters, you'll definitely want to use the name init. The 
name init implies no parameters. The parameters init starts 
off by sending the init method to its superclass, then initializing 
any instance variables that don't depend on parameters, and 
finally returning self, 

Here's an example; 

- init 

1 

[super init]: 
blockSlze - 512; 
return self; 

1 
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In this hypothetical example, blocksize is an instance 
variable whose initial value does not depend on a parameter. 
(In real life, we'd likely use a ^define or, in C++ a const, bui 
bear with the example.) Note that we sent the init message to 
our superclass before we do anything else. It is important that 
you send the initialization message to your superclass before 
you mess w r kh your instance variables or call any of your 
other methods. Reason being, when you call your 
superclasses' initialization method, you give your superclass a 
chance to initialize its variables and a chance to initialize its 
superclass, etc. 

If your class requires an initialization method that takes a 
parameter, give it a name that starts with Init, then add text that 
reflects the parameters. For example, suppose you had a 
sequence of classes, Shape, Circle, and Cylinder, where Circle 
was derived from Shape, and Cylinder derived from Circle. 
Asssuming it took no parameters, the Shape initialization 
method would be called init The Circle initialization method 
would require a radius, and might be called init Radius:, and the 
Cylinder's initialization method might be called 
init Radius: height:. You get the idea. 

A Multi-Class Example 

Designing your initialization methods can get a little more 
complex when you are working with subclasses. In the example 
above, the Shape class has an init method, while the Circle class, 
derived from Shape, adds a radius parameter in a method named 
init Radius:. So far, no problem. To initialize its superclass, 
in it Radi us: just sends an init message to its superclass: 

[super Init] 

But what alxmt the initRadius: height: method of the Cylinder 
class? Should it send an ink message to its superclass? That doesn’t 
make sense, since its superclasses’ initialization method is 
init Radius: and takes a parameter. The correct approach is for 
each class to include all initialization methods of its superclass, 
adding in any additional methods for extra/differing parameters 
that it brings to the table. In our example, Shape would feature an 
init method. Circle would feature init and in it Radius: methods, 
and Cylinder would feature init, initRadius:, and in it Radius-height; 
methods. 

Each init method will sent! an init message to its superclass, 
and set any instance variables unique to its class to a default value 
For example, the Circle init method would set radius to 0 (or 
whatever) and the Cylinder init method would set height to 0. 

Additional methods that are overriding existing super class 
methods send an initialization message to the superclass, passing 
parameters as appropriate. For example, the Cylinder inilRadius: 
method sends an inilRadius: message to Circle. 

Finally, methods tliat don’t have a matching method in the 
superclass send an initialization message to self using the method tliat 
most closely matches itself. For example, the Clide classes' initRadius: 
method sends an init message to self (no parameters), while the 
Cylinder classes’ initKadiu&height: method sends an initRadius: 
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message to itself but includes the radius parameter. Once the called 
initialization method returns, the calling method continues by setting 
its unique instance variables to the parameter passed in ro it. For 
example, once initRadius:height; calls [self initRadius: rt (which will set 
the radius instance variable to r) t it then .sets the height instance 
variable to h (the passed in height parameter). 

If the last few paragraphs have left you a bit dazed and 
confused, not to tvorry. Here's a program that brings this all to 
life. As you go through the code, try to follow the chain of 
initialization. Where dues each instance variable get initialized? 
Can you predict the sequence of initializations when 
initRadius:height; gets called? Try to work this out before you get 
to the project run at the end of die column. 

Hie source code that follows is a Tm H and “,h H file for each of 
the three classes Shape, Circle, and Cylinder, In addition, you'll see a 
listing for main.in. the tnainO function that starts the ball rolling. 

Shape* m 

$ import *Shape.h" 

©implementation Shape 

- init 
1 

[super Init] ; 

printft "\n[Shape fnit]\n" ): 

return self; 
i 

Send 

SllAPE.II 

Ifimpor t <0bj cc l. h> 

©interface Shape : Object 

) 

- init; 

Send 

CmCLE.M 

//import “Clrcle.h" 

©implementation Circle 

- init 

l 

[super init]; 

printft * [Circle Init] Set radius to 0.,,\n* ); 

radius * 0; 

return self: 

I 

initRadius:(ini)r 

I 

[seif init]; 
radius = r: 


Getting Started: Filling in Some of the Objective-C Pieces 


printff “[Circle initRadius] * Set radius to %d...\n", 
r ): 

return self: 

I 

fend 


ClKCLE.U 

#impure “Shape.h” 

©interface Circle : Shape 

f 

int radius; 

I 

init; 

initRadius:(int)r: 
fend 


CmNDF.R.M 

//import “Cylinder.h" 

#Emplementation Cylinder 


- init 

( 

[super init]; 

prititf( "[Cylinder initl - Set height to 3: 

height ® 0: 
return self; 


InitRadius:(int)r 

I 

[super initRadius;r]: 

printf( "[Cylinder IniLRadius]\n* ); 

return seif; 

) 

in \ tRadiusi(int)r height:(int)b 

I 

[self initRadius:r]; 
height - b; 
printf 

( * [Cylinder initRadius; height:! Sci height to Hd-.-lir, h ); 

return self; 

I 

fend 


Cyunder.h 

If import “Circle, h’ 

©interface Cylinder : Circle 

t 

int height; 

1 

- init; 

- initRadius;(int)r; 

- initRadius:(int)r height:[int)h; 

©end 
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^include "Cylinder.h* 


MAIN.M 


void mainf) 

( 

id shape = [[Shape allocj init]; 

id circle " [[Circle alloc) ininRariiuja :33l ; 

id cylinder * l [Cylinder alloc] InitRadius;2/ height;10j; 

[shape free] : 

[circle free): 

[cylinder free]; 


Running the Program 

When you run the program above, here’s whal you see: 

[Shape init) 

[Shape init) 

[Circle init) - Set radius to 0. i( 

[Circle initRadius] - Set rad Inn to 33... 

[Shape initl 

[Circle init) Set radius to 0.,. 

[Cylinder init] Set height to 0.... 

[Circle initRatfius] Set radius to 27... 
fCy1indor LnitRadiueJ 

[Cylinder initRadius:height:1 * Set height lo 10,,- 


As you can see, the listing is broken into three parts, each 
produced by the initialization of a Shape, Circle, and Cylinder, 
respectively. Note dial when (inside main an) we created a 
Shape and sent it an init message, this produced a call of the 
Shape classes' init method. Simple. Of course, we really 
should have left the init method out of the Shape class, since 
it doesn’t do anything but add overhead. If we left it out, the 
right thing would have happened (the init message would 
have found its way to the Object class). 

When we created a Circle and sent it the init Radius; message, 
we spawn a chain of init messages to Shape and then Circle. 
Finally, the InitRadius: message gets sent to Circle. 

The Cylinder object produces a similar chain of 
initialization. First, we see the chain of init messages from 
Shape to Circle to Cylinder, then the chain of initRadius: 
messages from Circle to Cylinder, followed finally by the 
initRadius:height: message to Cylinder. 

Till Next Month... 

Spend some time looking over this output till you get the 
pattern. Once you understand this initialization technique, 
think about what would happen if you added an Oval class as 
a subclass to Circle, with an added width instance variable. 
How would this affect the initialization chain? 

If you have access to an Objective-C environment, take the 
Lime to enter this code and take it for a spin. Add some methods 
of your own (an area method for Circle, perhaps?) and 
experiment! See you next month... SO 


Visit MacTech- Magazine’s Web site! 

http://www.mactech.com 



Mail 

enabl 

made 


I IS never been l his easy to add custom messaging to 
your applications. Send and receive moil Handle 
attachments. Jus! use ObjetiSel. 


Ideal for Infemet/lnttanet environment, ObjetlSel 
gives Macintosh, Be and Windows developers reliable 
APIs for MIME, SMTP nod POP3 protocols. ObjertSefs 
royalty free software components m perfect for 
developing applications which require integrated 
messaging services, from commercial software 
packages to custom corporate applications. With 
OhjedSet, you benefit ham moit piattxols without 
having to learn, code and debug them an your own. 


Come lake a closet look at our libraries, 
documentation and demo applications. They're on our 
Web just to you (htlpV/www.smartcodesoft.com). 
[townloud a free copy today and see why DbjetfSel 
APIs are the ecsiest you'll ever use. 


SMARTCODE 


SnrartaidB Software, Inc. 
Phon* [B47) 94$ 3ST4 
Fost- (847) 94 $4889 
http^/www smoircodesoft-cw 

in1ioles(tpsmnFtcodflsciff.toiTi 
In Europe: 

Phone: 4-33 4 67 59 3D 40 
Fat +33 4 6/ 59 30 48 
http^/www.smattttide ft 
mtsato@smoi (code, h 


MIME, SMTP and POP3 APIs for Macintosh, Be and Windows 
C+ + doss libraries 

Framework Integration using Power Plant, MacApp, MFC 

Documentation, samples and reusable code 

MIME encoding/decodIng: BaseH Quoted-Pdntable, UUDECODE, 

Bin Hex, AppleSlngle, AppleDauble 

Send messages using SMTP, retrieve messages using POP3 

Supports OpenTrtmsporl, NlarfCP, BSD So clefs, WinSock DLL 

Subscription price includes next two upgrades free 

Portable multiplalform version and source code also available 


June 1997 ■ MacTech 


Getting Started: Filling in Some of hie Objecttve-C Pieces 


11 




















PLUGGING IN 


by Fabrice Feri.no, MDL Information Systems 

Accelerating Code Resources 
and Import Libraries 



How your plug in can 
take advantage of the 
Power Macintosh run-time 
architecture without telling 
the host application 


Import Ijbrartes as Plug-ins 

The traditional mechanism for the 
extension of a Macintosh application has 
been the use of code resources. The 
Power Macintosh line of computers, and 
Us associated run-time environment, have 
enabled applications to provide a new 
way to implement extensions as import 
libraries using the “universal plug-in” 
architecture described in [41* However, 
even if the application does not provide 
explicit support for the use of import 
libraries as their extension mechanism, iL 
is possible and advantageous for a 
number of reasons to implement PowerPC 
native extensions as import libraries, and to 
still package the complete plug-in a 
single file without contributing to the 
clutter of the Extensions folder 

A Bit of History 

For a long time, many of the 
successful Macintosh applications have 
provided a mechanism to extend their 
functionality* In the 68k run-time 
environment, this mechanism relied on the 
loading and executing of code resources. 
However, this ty|>e of code has been more 


difficult to write than application code because of the limitations 
imposed by the 68k nm-time environment; no A5 world to 
reference the globals, the limitation of the size of the code 
resource to less than 32K, and limit to a single segment (because 
there is no jump table). 

The majority of the modem development environments 
provide some ways to overcome most of these limitations. The 
A4 register is cleverly hijacked to reference the globals of the 
code resource, branch islands or the 68020 32-bit branching 
instructions are used to allow code resource of a size larger titan 
32k. Still, writing a 68k code resource requires more care and 
attention to detail than the common application code. Readers 
interested in this area are directed to the excellent information 
available on this subject, (131,15J), 

The situation improved significantly with the arrival of the 
PowerPC run-time architecture. With the availability of the Qxie 
Fragment Manager (CFM), an integral pan of the PowerPC system 
software, it t>ecame possible to implement extensions using 
import libraries (colloquially known as shared libraries)* Each 
import library is a full-fledged MacOS citizen with its own global 
data space, and no size limits. Additionally, if virtual memory is 
enabled and the import library is located on a device that 
supports paging, the import library will be file-mapped and its 
code will not Lake space in the heap of the host application* With 
all these advantages, many PowerPC native applications (Code 
Warrior IDF*, FrecHand, etc...) quickly adapted their plug-in 
mechanism to use import libraries. 

However, some applications still require their extensions to 
be code resources (some of them have not be rewritten for the 
PowerPC architecture and others did not adopt the new 
mechanism for diverse reasons). For this ease, it is still possible 
to take advantage of the increase of performance provided by 
the PowerPC family of microprocessors by adopting an 
accelerated code resource. An accelerated code resource mns 
only on Power Macintosh but can be called by both a 68k 
application or a PowerPC application. 


Fabrice Ferine is a Senior Software Engineer in MDL Information Systems, Inc* in San Leandro, CA He may be reached 
at <labriee@indIi.com>. 
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Mac, go out and touch the world 
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ADB I/O lets the Mac be part ot the physical world. 
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The format of an accelerated code resource is simple: this is 
a CTM code fragment preceded by a routine descriptor The first 
instruction in a routine descriptor is the Mixed Mode Magic A-trap 
that triggers die mode switch necessary when the PowerPC code 
resource is called by 68k code. But accelerated code resources, 
although they provide some of the advantages of import libraries, 
still have some of the old limitations (sec [21 1-39). Finally, 
accelerated code resources have a very annoying characteristic: 
they have been difficult to debug with a source level debugger like 
the Metrowerks Debugger. The Macintosh Debugger from 
Apple provides some support for debugging memory-based code 
resource but it is still awkward. Source level debuggers become 
confused because the CFM removes the connection information 
from iLs tables after a memory based fragment has Ircen prepared. 
All these problems can be solved if most of the code of the 
extension resides in an import library. The accelerated code 
resource then is just used as an interface between the application 
and the import library. Figure 1 shows the general structure of 
a 68k code resource plug-in T of an accelerated code resource 
plug-in, and of a hybrid accelerated code resource-import library. 
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Figure /. Some architectures for plug-in code resources. Two 
other useful types not represented here are safe fat code 
resources and import library based safe fat code resources. Ihe 
article focus on the build of the third tyfye of code resources. 

RD: routine descriptor. 

Another advantage is that import libraries can have multiple 
entry points. If you need to implement several code resources, 
each one providing an entry point to the application, each of 
these code resources can call its own entry point in the import 
library. This design makes the development of plug-ins lhaL share 
axle much easier and offers the possibility for plug-ins to easily 
share data at run-time. This can be done without having to 
allocate some data structure in the heap and devising a 
mechanism to inform the plug-ins how to access litis import data. 
The idea for this plug-in architecture came when reading 12J1-40: 
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“Note that a code fragment stored as an accelerated code 
resource can import both code and data from an import 
library. The code and data in an import library do not move 
in memory, As a result you can sidestep the restrictions on 
global dam in an accelerated code resource by putting the 
global data used by die accelerated code resource into an 
import library,* 

To solve the debugging problem, this idea is extended to have 
most of the data and of die code in an import library'. 

A Model Plug-in Application Based on Sprocket 

An example host application Ls needed to demonstrate the 
implementation of import library based accelerated code 
resources. lasteacl of selecting one of the real world applications 
dial do noL take advantage of import libraries for their plug in 
mechanism, a modified version of the Sprocket framework that 
can load and execute plug-ins has been implemented. With these 
extensions, Sprocket becomes a good model of a 68k CFM 
unaware application. Note that the implementation is not claimed 
to be the best one, hut is simple and powerful enough to explore 
the concepts exposed in this article. Using a 68k program makes 
the environment even more hostile for import libraries. 

One main difference with real world applications is that the 
application does not scan a special plug-in folder but allows the 
user to load plug-ins by selecting the new Load Plug-in... menu 
item in the File menu. Consequently, the plug-ins used by the 
application can be located anywhere on any volume, (This feature 
will be used later in the artlide.) 

Most of die code for these extensions reside in a new file 
PluglnSupportcp, This hie implements the loading and initialization 
of plug-ins and the forwarding of events to the loaded plug-ins. It 
also implements a simple callback mechanism. The only function 
provided by die callback is the creation of a new r Sprocket window' 
so that a plug-in window' behaves correctly in the floating window 
environment of Sprocket. (A new subclass of Sprocket window 
designed to be used by plug-ins Ls also implemented. ) Otherwise, 
the plug-in rules are typical of those found with most applications: 
the plug-ins must be code resources of a certain Lype (‘PLUG 1 in our 
example), and the communication between the plug-in and the 
application is Lite exchange of pointers to data structures. The hie 
PluglnBtock.h defines how the application and its plug-ins 
communicate. 

listing 1: PluglnI3iock.il 

^define kNurnParam (&) 

r 

The align pragma will he ignored by most 68k compilers. If you arc applying ihc 
techniques described here for an old 68k application, it is very likely that the include 
file provided does not include these pragma statements: add them now bdoie you 
build vour PowerPC native pli^in 
7 

#if PRAGMA_AT*IGN_SUPPOITED 
^pragma options aligii^mac68k 
#eiuii£ 

// message that the plugin can receive 
enum 


plnglnlr.it. 
pluglnEvt, 
pluglnLoadFile, 
pluglnWindowniosed„ 
pluglnExit 
I; 

// callback request message seni by the plug-in 

enum 

f 

createWindow 

1: 

// the callback in the application will receive a pointer to this structure 

// message is the code for the operation requested by the plug-in 

// param is used to pass the parameters back and forth between the application 

// and the plug in 

typsdef struct 

t 

short message; 

Ptr pa ram [kNumParam] ; 

) CalIbaekParamBlock, *Callbackl i araniPtr; 

// definition of the callback entry point 

// we use pascal calking convention because C calling conventions may vary' between 
// compilers 

typedef pascal Boolean C*Call£ackEntryPoint) 

(CallbackPararoPtr pb); 

// I he phig-in will receive a pointer to this structure 

// similar to the struct received by the callback with the addition of 

// a pointer to the callback function in the application 

typedef struct 
I 

short message; 

Ptr paratn [kNumParaml ; 

Ca1TBackEnt ryPn1nt callback: 

] PluglnParamBlock. * PluginParamPtr; 

// definition of the plug-in entry point 

// we use pascal eallling convention because C calling conventions may vary between 
//compilers 

typedef pascal Boolean (*PlugInEnti:yPoint] 

(PlugTnParamPt r pb); 


The Plug-in: a Qijk:kDraw3D Viewer 

The plug-in implemented is a QuickDraw3D file viewer, 
QuickDraw3l > is available only on Power Macintosh* (A Windows95 
implementation should fx: available by die time you read liiis.) 



Figure 2* The QuickDraw3D viewer plug-in in action. 

To build tiie plug-in we will use two projects.- one for an 
accelerated code resource as the bridge between an import library 
and the host application, the other for die import library with all of 
the code of the plug-in. The accelerated code resource and import 
library will be packaged as a single file, instead of adding yet 
another file to die growing crowd in the Extensions folder. This 
also facilitates installation and removal of the plug-in. (The 


continued on page 18 
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- Mae liner Edit ors Ch nice Aw a rds, 1993 



“A distinct improvement over ResEdit 

- MacTech /MacTutor 

“Resorcerer 's data template system is amazing!” 

- Rill Goodman, author of Compact Pro 

”Nuke ResEdit! Re sorcerer is mission-critical for us , w 

- Dave Winer , User land Frontier 

“The color pixel editors are wonderful / A work of art! ,p 

- Dave Winzler, author of Microseeds Re dux 

“Every Macintosh developer should own a copy of Resorcerer.” 

- Leonard Rosenthal, Aladdin Systems 

“Resorcerer will pay for itself many times over in saved time and effort 

- MacUser review 

u The template that disassembles PICTs is awesome!" 

Bill Steinberg, author ofPyro! and PBTools 

“Resorcererproved indispensible in its own creation!” 

- Doug McKenna , author of Re sorcerer 

a ***a wealth of time-saving tools.” 

MacUser Review, Dec. 1992 
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Version 1.2.4 


The Resource Editor for the Macintosh Wizard 


ORDERING INFO 
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60-day Money-Back Guarantee 
Domestic UPS ground shipping 
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• Powerful icon family editing (all 9 icon types) 

• Color pixel anti-aliasing, dithering, and lots more 

• Complete ‘PICT* disassembly and reassembly 
New 1.2 Features: * Resource sorting; ROM resource browsing 

• 120 template field parsing types now supported 

• New insertion & deletion template field types 

• Text-only ‘PICT resources 
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• Easier, faster, more Mac-Tike, and more productive than ResEdit 

• Safer memory-based, not disk-flle-bascd, design and operation 

• All file information and common commands in one easy-to-use window 

• Compares resource files, and even edits your data forks as well 

• Visible, accumulating, editable scrap 

• Searches and opens/marks/sclccts resources by text content 

• Makes global resource ID or type changes easily and safely 

• Builds resource files from simple Rcz-like scripts 

• Most editors DeRez directly to the clipboard 

• All graphic editors support screen-copying or partial screen-copying 

• Hot-linking Value Converter for editing 32 bits in a dozen formats 

• Its own 32-bit List Mgr can open and edit very large data structures 

• Templates can pre- and post-process any arbitrary data structure 

• Includes nearly 200 templates for common system resources 

• TMPLs for Installer, MacApp. QT, Help, AppleEvent, OCE, GX t etc. 

• Full integrated support for editing color dialogs and menus 

• Try out balloons, £ ietl/s, lists and popups, even create C source code 

• Integrated single-window Hex/Code Editor, with patching, searching 

• Editors for cursors, versions, pictures, bundles, and lots more 

• Well-designed, helpful developer tools being added all the time 

• Relied on by thousands of Macintosh developers around the world 
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r„ob PCs is tor you .' MacTcch MAGAZINE 
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Yes, Tools Plus has it! 

* Create any element using a single routine 

* I! very thing work* as soon as you create it 

* Automate* all standard GUI eJemeais 

* Windows. Tool bar and floating palettes 

* Buttons tall kinds, flat and 3D) 

* Scroll bars ispeed control, live scroll ing) 

* Wurld-class custom controls 

* Fields w/scrull bars, filters, autoediting) 

* Picture buttons (the best anywhere) 

* List boxes 

* CDEF and LDEF automation 

* Cursors (color, animated, auto-change) 

* Menus f pull-down, hierarchical, pup-up j 

* Edit menu (undo/redo, automatic editing) 

* Panels (3D, group boxes, lines, panes) 

* 3D titles (raised or inset) 

* Extended multi-monitor and color support 

* Clipboard automation 

* Dynamic alerts mo resources required) 

► Event processing automation 

* Over BOOK of custom fonts, icons, cursors, 
and other useful resources 
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Plus thousands mart exciting features and services! 
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SilperCDEFS $89 value 

:/professionally designed and crafteri control* 
✓ dozens of 3D & lint buttons, tabs, sliders 

Tools Plus tor 
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continued from page 14 

Extensions folder should really contain only the import libraries 
used by several applications, that is shared libraries, and not every 
import library used by any single application.) Each CodeWarrior 
project will use the product of the other project, so this requires 
some bootstrapping. Since we must have the PEE of the import 
library to successfuily link the accelerated code resource, we start 
by building the import library. 

The Import Library Project 

The import library will export only one symbol: its main 
function called PluglnMainQ. This function, like the code resource 
entry point, accepts a single parameter, a pointer to a 
PluglnParamBlock, and returns a Boolean Displaying a 
QuickDraw 3D file is very easy because QuickDraw 3D provides a 
QDdDViewerQbjea that does most of the work [1|, The other 
interesting parts in the code arc the definitions to build and call a 
universal procedure pointer (UPPs) to get to the callback 
procedure in die 68k application, ihe classic trap is to copy and 
paste similar definitions from the universal headers. However, the 
definitions in die universal headers are there to help set up UPPs 
for the functions in the source file not for the functions called by 
the source file. In this example we know that the callback 
procedure is in 68k code, so we use kM68kt3A for the run-time 
architecture parameter in IMewRoutineDescriptor{). 

Listing 2: rniun.c 

y* fe4 Jl*4i***■*» **+ w 4t iX ** j* * » M 

main.c 

Entry point for the import library 

[/include “PluglftBlcck.h* 

#include <QD3DViever,h> 
jflnclude <CodeFragnieMS,h> 


typedef ITniversalProcFtE Cal iBacJcUPF; 


// procedure info for the callback procedure 

entim [ 

calIflackprocInfo - kPaScatStackBased 

RESULT_SIZ£tSlZ£_C0nE(5l/rCuf (Boolean) 3) 


si; 


STACK.ROUTlNF.HARAMFTHIri l. 
ZE_C0DE( sizeoi (CallbackParamPt r)) J 


I; 


// macro to create and call a Universal Procedure Pointer fur the callback 
// We know the callback is 68K code so we make sure we are usin^ 

// the constant kM68kISA. 

//define bewCailbackProcCuaerKoLit ine) ^ 

(CallEackUPP) \ 

NewRoutineDescriptor{(ProcPtr)CuserRoutine),V 
callBackFrocInfo, kMbBkISA) 

/fdefine Call Cal IBarkProc(userRoutine, paratn) \ 

Call Universal Prc>c( (Culver sal P roc Ptr) (userRoutine), \ 
callHaekProclnfo, parafc) 


// typedef to satisfy the compiler when checking for unresolved symbols 
typedef TQ3VieverGbject DGJVieverNewFrocType) 

(CGcafFtr, Rect*. unsigned long): 


ff Our globals 

Window?tr 
TQ3Viewer0bject 
Boolean 
FSSpec 


gKyWindow; 
gMyViewer; 
gFIleOpened; 
gCurrentFile; 


// our window 

// the QD3D viewer object 

ff lias a file been opened ? 

ff FSSpoc of the file being displayed 
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// prototype for the exported function. We use pragma export 

// to inform Code Warrior that this is an exported function, 

jfpragma export cm 

Boolean FluglriMaintPluginParamPtr pb); 

#pragma export off 

// prototypes for functions in this file 

Boolean Dolnit (PlnglnParamPtr pb); 

Boolean DoOpenFile(PiuglnFaramPtr pb); 

Boolean DoW!ndowClosed(PluglnPatamPtr pb): 

Boolean DoEvcnL(PluglnParamPtt pb); 

Boolean DpExit £ Filial nParamPtr pb) ; 

Boolean Get3DViever( PluglnFaramPtr pb); 

Boolean IsColorFort(GrafPtr port): 

Boolean Same File ( FSSpec "sped, FSSpec ‘spec2 ); 

PluglnMain 

PluginMain 
Exported function. 

Based on tire message Jo wards the call to the appropriate 
function 

Boolean PluglnHainf PluglnParamPtr pb) 

( 

Boolean retVal: 
switch( pb ssage) 

case piuglnlnit: 

retVal - Dolnit(pb): 

break: 

case pluglnipoadFilc: 

retVal = DoOpetiFlle(pb): 
break: 

case pluglntfindowCiosed: 

retVal ■ DoWindowClosed(pb); 
break: 

ease pluglnEvt: 

retVal - UoEvent(pb); 
break: 

case piuglnExit: 

retVal - DoExit(pb): 

break: 

default; 

retVal ” false: 
break: 

1 

return retVal: 

I 


Dolnit 

y ■ ■ i■ ■ ■ ■ 11 »j t *■ i> t »i■ * t *Mil 11**1 **i«t *♦>*»**♦♦** 

Dolnit 

Deal wit It tlic mil message, 

Boolean Dolnit(PluglnParamPtr /*pb*/) 

[ 

// verity the presence of QmckDraw3D Viewer 
return (QWiewcrNcw !~ 

(Q3V i owerKcwFtocType) kUnresolvedCFragSyrnbalAddress] : 

I 


■w mu *«w*»*rt ****** r»*+ ♦ hm *************** 


DoOpenfile 

User wanted to load a file.Snif it and open it if we can. 
Application sends u$ a pointer to the FSSpec in paramfG|. 

Boolean DoGpunFile(PluglnParamPtr oh) 

I 


Boolean retVal: 
short refNum: 

FInfo filelnfo; 

Boolean dataFIleOpen w false: 


// is it again the same hie f 


DoOpenFile 


Powerful enough to 
handle all your bug 
tracking needs. 
Affordable enough to 
put on everyone’s 
desktop. 


Introducing TestTrack 1.5 
and Solo Bug! 


Discover the tool more and more of today's top software developers are using 
to improve the quality of llieir Mac and Windows applications—TestTrack 

* Thick bugs, feature requests, customer * Save lime and improve tech support by 

information, and more. giving Solo Bug mir stand-alone bug 

* Use on Mac or Windows 9VNT platforms, reporter, to your customers (comes free 

* Produce concise nports. with TestTrack 1.5). 

* lank engineers, testers, managers, even tech • TYack the history of each hug, 

writes. * Multiple users, ftdi security! 

■ Automatically route hu^ to team members, * kteal for coreulianis loo! 



To order call 513-683-6456 

Rapine Software, Inc. 1066 Seapme Cl Matocrille, Oil 45A39 


sales@seapme.com Se tip ill 6 

http://www.seapine.com Software 


If (gFllcOpened 

SameFile( &gCurrentFile, (FSSoecFtr) pb->paratn[Q])) 

t 

return true; 

1 

retVal “ (FSpGetFInfo( (FSSpeePtr) pb >param[0l, 
ifilnlnfo) — noErr && 
filelnfu,fdType ’IDMF*); 

// open the data fork of the file then 
if (retVal) 

f 

dataFileQpen = 
retVal = 

(FSpOpenDFf (FSSpecPtr) pb >param[0l. fsCurPcrm. 
irteOJum) “ noErr] ; 

) 

// make sur- we have a 3D viewer 
if (retVal) 
f 

retVal - Get3DViever(pb); 


//and tell the QD3DViewer to use it ax the source of its data 

if (tetVal) 

I 

retVal = (Q3ViewertteeFiIe( gMyViever. refNum) = noErr); 

// force a full redraw right now. 

Q3ViewerDrawfgHyViewer); 

I 

// dose the file here if it was opened 

If (daiaFileOpen) 

FSClose( refNum): 

I 
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if (retVal) 

I 

// store data in mirglobals for next tall 

gFilcOpencd w true: 
EluukMuveDalat pb >puram[G3 , 
&gCurrentFile f 
sizeof(FSSpee)); 
I 

return retVal; 

J 


DoWindowGoscxl 

DoWiiidowCloscd 

Use r dosed a window. If ii is ours, release our data. 

Application st uds us a pointer to the WmdowRceord in para m [Of 

Boolean DoWindowClosedt PluglnParamPtr pb) 
i 

Bool nan retVal: 

retVa1= (gSyltfindow — (VlndowPtr) pb >paranfO]): 

If (retVal) 

f 

Q3ViewerDispose( gMy Viewer}; 
gMyViewer “ MULL; 

} 

return retVal; 


Do Event 


Do Event 

Application got an event? Ts it ours? 

Boolean OoEvenL(PlugXnFaraniFtr pb) 
( 

Boolean retVal; 


if (gMyViewer) 


i 


retVal = Q3ViowerEvent( gMyViewer, 

(EventRecord *) pb >parara[0]) 


) 

else 

{ 

retVal* false: 
I 

return retVal: 


DoExil 

We are being dosed down. Release our objects. 

...— ; 

Boolean UoExit(PluglnBaramPtr /* pb */) 

l 

if (gMyViewer) 

( 


Q3VieverDi£poee( gMyViewer); 
gMyViewet = NULL; 

* 

l 


DoExii 


Gct3DViewrr 

GeiJlMtwtr 

make sure we have a ^DViewer 

Bool ©an Gc HOVI ewe r ( Pi u&I nFa ramF I r pb) 

I 

CallbaekPiu aiiBlock epb; 

Cal IE ackU P F cal I Back; // UPP for the callback 

Rect wRect: 

ff do we have a viewer already ? 

if (gMy Viewer NULL) 

I 

Boolean ok; 

// asks the application fur a window using tlie callback 
// create UPP on the heap 


callback = NewCalliiaekProc( pb-x^Uback); 

// fill callback parameters 

£pb.message “ ereateWindow; 

ok = CallCallBar.kProc ( callBack, &epb): 

// dispose of 11PP 

DisposoRou l ineftoscriplor( callBack); 

// extract the WimJowPtr if callback successful and verify the 
// port Reel is ool empty and it is a color port 

if (ok) 

I 

gMyWindow * (WindowFtr) cpb.paramfOl; 
wRect = gtfyWindow->portRect; 
ok “ (1 (EmptyRect (&wRe.c.t))) && 
(IsColorPOTL(gMyWindow)); 

I 


//All the checks have been done: create a QD^D Viewer object 

if (ok) 

I 

gMyViewer = QBVieverNciw( (CGrafFtr) gMyWindow, 

JvwKect, 

kQ3ViewerDefault); 


] 


return EgMyViewer != NULL); 

1 


r 


IsCnlorFtitt 

l he magic routine to test if a GrafPort is just a CGrafPort 
in disguise 


Boolean IsGolorPort(GrafPtr port) 


IsColorPort 


I 


return port ? ((((GGrtfPtr)port)->portVersion & 

(short)OxGOOO)) "" (short )OxCOOf) : false; 


Samd'llc 

Samefile 

Are two FSSpec refering to the same file? 

Boolean SameFile ( ESSpec *specl, FSSpee *spec2 ) 

l 

return (sped->vRefNum = spec2->vRefNum) && 

(aped ■>parIC l- spee2->parID) && 

EtjualSl rll>g( sped >namp. sped >name* false, true ): 


TIk 1 last thing lo mention alxjui the imjxjn library is the 
settings for the project: make sure to specify PluginMain as the main 
function of the Import library in the PPG Linker preferences panel, 
and in die PEF preferences, select use /^pragma in the topmost 
popup menu for the export symbols. (Code Warrior offers other 
ways to specify which symbols are exported, the point here is to 
make sure the PluglnMain is indeed exported.) The MPW tool 
DumpPEF can be invaluable Lo check which symbols are exported 
or imparted by a PEF container like an import library. 


The Accelerated Code Resource Project 

The accelerated code resource project is even simpler, at 
least in its first version. It consists of only two files: stub.c to 
forward the parameters to the import library entry point and then 
return the result of the call lo the application, and the import 
library which was jusi built and which will be used by the linker 
to set up the imports of our code resource. 
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In its first version, the code for the accelerated code resource 
has an almost embanusrng simplicity: it just calls die exported 
function from the import library. (Remember that this simplicity is 
desired because of the difficulty of debugging accelerated code 
resources J 


listing 3: Stobx (version 1} 

// Procedure info t or the code resource entry point .This will be used by 
//Code Warrior to set up the routine descriptor in front of the code fragment. 

tm\m ( 

codeRosourcei J roc I rjfo " kPasralStackBased 
I RES0ULSiZB(SlitjG0flE(9taeof(Boolean))) 

| S TACK_R0UTINiiLF ARAMETKK(1. 

SIZE_CODE(sizeof(PluginParamPtr))) 

h 


// prototype fi*r the import library exported function 

extern Hooloan f J 1 ugTnWairt( FluglnParaJiiPtr pta ); 

// symbol used by tk«k'Warrior w hen building the accelerated code resource 

ProcInfoType _procinfo “ codeResourecProcTnFo: 


// prototype for the code resource entry point 

pascal Boolean isaint FluglnParauiFtr pb); 


.. 

main 

Code Resource entry point 

In this lirst version, just call the entry point 

MtMtMnmititl iv*n <MTfTft<n< y 

pascal Boolean main( PluglnParamPtr pb) 

I 

return EluglnMalnt pb): 

1 


main 


The project generates a file that contains the 'PLUG' 
accelerated code resource, which is then added to the import 
library project in the final step of the bootstrapping sequence. 
From now on T the PLUG* resource will he automatically added 
(like any other resource) to the resource fork of the import library 
file by the CodeWamor linker. 
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figure JL the final project for the plugin 
QDjh)PlugfttStu hrsrc is the file providing the TWO" 
accelerated code resource. 

The piug-in is now retidy to use. The application calls the PLUG 
resource that forwards the request to die import library that cm 
directly call hack to the application. Everything works perfectly until 
we move the plug-in away a directory other than hie application 
directory, such its to a Plug-ins folder. What is happening? 
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The Need for Manual Load 

The problem is that our accelerated code resource Ls not a full 
citizen in the MatOS, and the CFM cannot resolve the import in die 
code resource, namely PluglnMainQ. The code resource resides in its 
host application process and , although the import library is Lhe .same 
physical file as Lhe axle resource, it is no longer in the CFM search 
path. Tile CFM search path Ls thoroughly described in [2] (p 3-7). lhe 
CFM searches lor imported libraries in the directory of the fragment 
being loaded only (and this is not the case heie) if the fragment is 
being loaded by a call to GetDiskFragment() or GetSharedLrbrary(). If 
this search is not sucessfu), die CFM tries to locate the import library 
in the application file, the application library directory (specified by 
the application l cfrg T resource), the application directory, the 
Extensions folder in the System Folder, the ROM registry and Finally, 
a file and directory registry currently private to the CFM, Placing our 
code resource-import library hybrid in a plug-in folder effectively 
removes the import library from the search path. Does it mean our 
hybrid will have to either clutter the application directory or lhe 
Extensions folder? The solution would be to programmatically load 
the import library. The CFM provides the necessary function: 
GetDiskFragmenf() will load a fragment contained in the data fork of 
a file specified by a FSSpec: 

OSErr GetMskEragment( FSSpeePtr FileSpee, long offset, 
long length, Str63 fragNatnp, 

LoadFIags find Flags. 

Connection!!!* connlD, Fir* rtminAddr* 
Kir2!*3 errName); 

lhe last remaining problem is to get die FSSpec of the file 
containing the acc elerated axle resource. If the fragment had been 
disk based, it could gel iLs own FSSpec courtesy of the CFM by 
exporting a connection initialization routine. This type of routine is 
called by the CFM after a fragment has Iieen loaded and prepared 
and should conform to die following definition: 

OSErr MyConnectionInltializaiionRoutine( InitBlock* 

connectionlnfo); 

For disk based fragments, one of the fields in the InitBlock 
structure is actually the FSSpec of the file containing the code 
fragment. However, if the fragment is memory based (and this is 
the case for accelerated code resources), the InilBlock specifies the 
address and size of lhe fragment but not the FSSpec of the file. 
However, since the loading of the plug-in import library is only 
needed once, using the connection initialization routine to 
perform this step is convenient. 

There is no universal solution to this problem, because it 
really depends on the run-time environment provided by the 
application for its plug-ins. The technique described here will be 
applicable in almost all the cases however, since it relies on 
minimal assumptions typical of most applications: the resource file 
of the plug-in is left opened by the application, and die plug-in has 
either a unique resource ID or a unique name. The loading code 
will work even if the plug-in is not the current resource file (some 
applications set the current resource file to themselves after loading 
plug-ins). The current resource file is not necessarily the plug-in 
file since the connection routine is executed just before the first call 
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to die main() routine of an accelerated code resource and not w r hen 
the resource is loaded. 

To get the FSSpec of its own file, the code resource will set 
the current resource file to die top of the resource chain to be sure 
its file is in the resource chain, look for itself in the resource chain 
with GetResource() (or GetNamedResource()), obtain its own file 
reference number with HomeFte$File(), and convert the file 
reference number to a FSSpec with PBGetFCBInfo(). 

Listing 4: Stub.c (version 2) 

//include "PI u&TnBl ock *h" 
include <CodcFragnieritK,b> 

// our own identity 
//define kResType ’PLUG" 

//define kResId (1000) 

// dm structure b the C description of a Mac Resource Map 
typedef struct l 
long daraOffset; 
long mapOffsct: 
long dataLength; 
long mapLength; 

Handle nertHap; 
short fileRefNun: 
short FileResAttr: 
short typeListOffsot; 
short uameListOffsci; 

I RcsourceMap. “ResourceHapFtr, 4 ‘KesoureeMapHandle; 

// exported from I lie import lib 

typedef Boolean (‘CFHFluglnEntryPoint) (Plug!nParamPtr pb): 
enum I 

codeftesourceProcTnfo “ kPnscalStackliased 

I RESUl>T_5IZ6(SiZE_C0UK taizeof (Boolean))) 

| ST A C*LRU UTl NE_P A RAM liTE R £1 , 

S1£E_G0DE( sizeof (PluglnParamPtr))) 

Is 

// fur autoload 

extern Boolean PluglnMalnf PluglnParasiPtr pb ): 

// the import library entry point 

CFMPluglriEntryPoint gPluglnMain; 

// used by CW for accelerated cotk resource 
FrocInfoType _procinfo * codeReaourceProcTnro: 

// prototype for the code resource entry point 

pascal Boolean main( PluglnParfmPlt pb) ; 

//connection initialization routine and prototype of the utilities 
OSErr VetilySharedLibrary( InitBlockPtr InitBlock); 
aLatic OSEre RefNuntfFSSpec( short theRefNua, 

FSSpecPtr theSpee); 
static short SetResToTop(void) ; 

rnnin 

p lit <i Mi lit! ,MII it, i I ■ ■ i I + i I Httilllliiii IfikliiliiHiilAiit 

main 

Code Resource entry jxjint 

verify our global is set up and call lhe import library 

entry point as before 

pascal Boolean main( PhjgTnParanPtr pb) 

\ 

Boolean retVal 31 false: 

// Verify wc did resolve the import 

if (gPluglnHain 1 = 

{CFHFluglnEntryPoint) ktJnresolvedCFragSyfibolAddress) 

I 

retVal “ ( * gPluglnHaln) (ph); 

\ 

return retVal; 
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Purify on Unix 
Bounds Checker on Windows 
Now, from the makers of QC, comes... 



On Macintosh 


Find Hugs Fas l 

Spotlight is the first Automatic Memory Debugger fur the 
Macintosh. Instantly detect invalid memory accesses, had 
toolbox parameters, leaks, stack overwrites, memory reloca¬ 
tion problems, and much more, 

Spotlight uses your XSYM file to automatiailly parch your 
application — no need to change your source code, No need 
to recompile. No learning curve whatsoever* 

The interface gives you instant feedback when an error is 
detected. You can ignore the error, igm >re all future occurrences 
of rhe error, or log die error to a Lexi file for later analysis. 

Fine Gntined Memory Protection 

Spotlight identifies reads and writes outside of the applica¬ 
tion and system heap. But it does not stop there. Spotlight's 
Object Code Replacement instrumentation inspects each read 
and write instruction in your code, detecting faulty memory 
reads and writes that occur between blocks, in released blocks, 
across multiple blocks, and in ROM. 

This technology works on any heap object you can allo¬ 
cate: Mac heap objects, C ‘malloc’ heap objects, even C++ 
objects created with new. 

Spotlight stops your application whenever a faulty memory 
access is about to occur and displays the exact source code 
line where it will happen. The calling stack is shown along 
with a display of all variables. A memory viewer shows the 
erroneous memory address and contents. 

Toolbox Validation 

Spotlight checks parameters to over 400 toolbox API calls, 
automatically validating handles, memory blocks, return val¬ 
ues, and so on. Specific checks catch subtle errors such as draw¬ 
ing into an unlocked GWorld, passing an invalid window 


pointer, passing an address within an unlocked handle m a 
routine that may rmtve memory, and too many more to list. 

Leak Detection 

No more struggling with Macs Bug. On program exit Spot- 
light provides a clear listing of all leaked memory showing a 
full stack trace from where the memory was allocated. Instantly 
discover all leaked Mac OS objects, rualloc’d objects, 
C++ objects, mid resources. 

Limitations 

Spotlight requires an XSYM file to function. MPW and 
Code Warrior users can generate these directly. Symantec us¬ 
ers must use TbolScrvcrto link with an XSYM capable linker. 
Spotlight requires a PowerPC processor. 

Spotlight works on the object code, No source code is re¬ 
quired: just the thing for resting purchased third party libraries. 

Availability and Pricing 

Pricing for Spotlight DR1 is $199 US (plus $5 shipping and 
handling within the continental US, $15 for international 
orders). This includes a free upgrade to the GM version and 
access to ftp interim upgrades leading up to GM. QC users can 
cross-grade to Spotlight for only $149, 

All Onyx products carry a 30 day no questions asked money 
hack guarantee. 

Onyx Technology, Inc* 

7811 27th Avenue West 
Bradenton, Florida 34209 

sal es@onyx-tech .c om w ww.ony x-teeh.com 

941 795-7801 941 795-5901 (fax) 



SpoiliRhc and QC arc rr^dorrwrb; pf Onyx TechiiotuKY, liui. All olhtr irnski.tiiirts wtv iiiflpfaly of their respetrive owner*. 








VerifySharedLibrary 


iheError = PBCetFCRInfoUparamBiock* false): 


VcrifySharcdLjbnry 

Gxmccifonlnitutizalkjn mutinc lhai verifies that the imjxm library- is 
loaded, and if mu load It pmgrjmrmhcolly. 

OSErr VerifySWfdlJbr.rryt InltBlockPtr /*initBlocW) 

\ 

Handle codeUesourceHandle: 

FSSpec myl’SSpec; 

ConnectionID myConnection; 

Str25$ myErrox: 

short myRefNutn; 

OSErr myErr ■ noErr; 

unsigned char wyEmptyString - 0x00; 

if CgPhjgTrHa In 

(CFMPluglnEn try Point) kUnresolvedCFragSymbolAddresa) 

I 

// the CFM lias not been loaded > do it ourselves 
// lhe flrM pan is to line! our resource handle 

// m that we get to our rtf ntmThe in Mem infr> from the Init Block b useless 

short oldResFiln • SetRnsToTopO; 

// get our own handle 

codeRtsourcellandle = GetResourciCkResType, kfcesld): 
if (codeResourceJfandle = MULL) 

{ 

mvErr * ResErrorf); 

I 

// with the handle, get our file refmim 

if (tsyErr noErr) 

I 

ittyRefNuta * HomeResFi 1 e(codoResourcefla nd1 e d 

// now get the FSSpec corresponding to the refmim 
// this is much easier than you think 

myErr ” Reffluni2FSSpec ( myRefNuci, &ayFSSpec ); 

If (tnyErr ^ noErr] 

I 

myErr ■ CetDiskFragtnent t &myFSSpec, 

0« // effect (l for fragment 

ktfho 1 cFo rk . // whole data fork 

kinyKatpiyE Lring h // used for debug 

kLoadkib. //load it 

kniyConnection * // gel the connection 

(Ptr *) igFluglnMain, //get address directly 

myError): 

I 

if tmyErr 1“ noErr) 

( 

// fust to stay on the safe skle 

gPlugTnMaln = kUnresolvedCFragSymbolAddress; 

I 


// restore current its file lo its old value not to confuse the application 

UseResFile(oldResFile); 

I 

else 

{ 

gPl ugInMa f n ** P1 uglnMa in; //Fragment loaded automatically 

i 

return myErr; 


RcfNum 2 FSSpcc 


RcfNum2FSSpec 

given a lite refNum, returns the tile FSSpct 

OSErr Re fNum2FSSpec ( short theRefNum, FSSpecFtr theSpec) 

I 

FGBFBRec paramUlock; 

OSErr theError: 

Sxr255 theMane; 

paramBlock,ioCnraplntIon “ nil: 
pa ramB]nek,IoName'Plr" lheName; 
paramBlnck,ioVKofNmn^ 0: 
paramBlock. ioKefNutn s theRetNum; 
pnrmnHlock.ioFCBIndx= 0; 


if (theError «* noErr) 
f 

theError 15 FSMakeFSSpec(paramRlock.ioFCHVRefNum* 
paramBlock* ioFCBParll)* 
thcNasre * 
theSpecj; 

I 

return theError; 

1 


SciResToTop 


SetResToTop 

Sets the current resource file m the top of the resource map 
Returns the current resource flic before the call, 

short SetResToTop(void) 
f 

short topResFilu; 
short oidResFile; 

// Save the current resource file 

oIdles File = CurResFileO: 

// now sets the current Resfite to the of the resource map 
// using die tow-memory global TupMapI fnrfl 

topResFile = (^((ReftourcoMapHandle) 

LMGet TopMa pHnd10 J). file RefNum; 
UgeResFUe(topResFile); 
return oldResFile; 


To improve the robustness of the manual loading of the import 
library, instead of relying on GetDiskFragmentQ which simply returns 
a transition vector to the main eniry point of the import library t the 
code could use FindSymbolf) to verify that Lhe import library loaded 
by GetDiskFragmentO exports a routine with the expected name, 

myErr = FindSymbol( 

my Connect i on * // obtained with Get!XskFragment0 

"YpPlugltiNainh // name of routine to look for 
(Ptr*)AgPlog!nKa iti, //grt addressdirectly 
fcsymbolType) ; // get dais of symbol (transition vector, data) 

Evidently, calls to FindSymbolO are necessary if Lhe axle 
resource does not call the main entry point (this would happen if 
fhe import library' implemented the axle for several distinct code 
resources all calling different entry points). 

The other modifications to the import library project are the 
specification of VerifySharedLibrary as the connection initialization 
routine (Figure 4) and the addition of two libraries: InterfaceUb to 
link with all the Toolbox routines used, and MWCRimtimeUb to 
provide the glue to call the transition vectors obtained with 
GetDiskFragmentQ or FfndSymbo!(). A transition vector is a function 
pointer associated with the value of the Table Of Contents register 
(RTOC) used to reference global data in (he called code fragment 
(121 p,1-2<V). Calling a function located in another axle fragment is 
known as a cross-TOC call, and the MWCRuntimeLib automatically 
provides the glue to set the TOC register before and alter cross- 
TOC calls. The C programmer just deals with classic C pointers to 
functions* 

Finally, the link to the import library should be set as 
"weak" so that the CFM does not give up loading and preparing 
the accelerated code resource if it cannot resolve die import. A 
weak link gives the conned ion initialization routine a chance to 
resolve the imports. 
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Download the architectural overview or view it on-line with Adobe Acrobat 3.0 
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The most powerful object-oriented database engine available 

NeoAccess 4 displays electrifying performance—up to While others promise cross-platform - MeoAccess 

ten times that of the competition. Behind its elegant delivers. NeoAccess is a set of C++ classes designed for 

programming interface is a fully optimized relational use with popular compilers and frameworks on Windows', 

query engine buhl for speed. It also has an object cache Macintosh*, and Unix platforms. Thousands of developers, 

with automatic garbage collection so your applications including America Online' and Claris", have already 
can run in a much smaller memory footprint than you found that NeoAccess enabled them to build fast, powerful 

ever imagined possible. And NeoAccess has no runtime internet applications in record time. That's why there are 

fees so you pay one affordable price no matter how many more NeoAccess based applications on end-user 
copies of your application you use or sell. machines than any other object database backend. 
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Figure 4. Setting the connection initialization routine 
of the accelerated code resource. 


even easy to convert an existing accelerated code resource to use 
the hybrid architecture. All these advantages should speed up die 
development of new plug-ins of belter quality for all the 
applications that still do nol take explicidy advantage of the CFJML 
This hybrid design also can be used to develop private or fat safe 
code resources. (For more information on this type of code 
resource, see [5].) Finally, packaging the code resource in the same 
file helps reduce the System Folder clutter 

Even if you do not have a accelerated code resource project 
in the foreseeable future, the techniques presented here may 
give new ideas on how to take advantage of the power and 
versatility of the CFM, one of the most awesome parts of the 
Macintosh Operating System. 


Conclusion 

Adopting the mixed architecture with import libraries for 
accelerated code resources offers several advantages: the code of 
the plug-in does not impact the amount of free memory of the 
application, data can be easily shared between the plug-ins, the 
developer does not have to deal with the limitations inherent to the 
use of code resources, and can debug using mainstream source 
level debuggers. The implementation of these hybrid files is very 7 
easy once the stub resource has been built. Most, if not all of the 
development effort is then spent in the import libra ry code. It is 
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THE TRADE 
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by John R. Powers, III, guide Works ^ 


AG Author 


A new authoring tool 
for Apple Guide 


Introduction 

AG Author is an authoring tool for 
Apple Guide content, A previous MacTech 
article ( Powers, 1996) reviewed other Apple 
Guide authoring tools and this article reviews 
ihe newest entry. 

First Impressions 

AG Author is available directly from 
the developer and publisher, Lakewood 
Software. You can download a com pile- 
disabled version from their web site 
(Internet resources are at the end of this 
article) and request a registration number 
from Lakewood to upgrade to a fully 
functional application. This registration 
number is also used for enabling 
software updates. 

Installation 

Installation consists simply of 
unstuffing the downloaded file and placing 
it on a hard disk. The provided Espy fonts 
must be dragged to the Fonts folder. These 
fonts must be installed before authoring for 
Apple Guide. Apple Guide users do not 
require these fonts. 

The downloaded software does not 
include two essential components. They 
are Guide Maker LiLe and the Claris XTND 
system. Guide Maker Lite compiles the 
output of AG Author into an Apple Guide 
document. Guide Maker Lite in turn 


requires the Claris XTND system if any elements other than plain 
text documents are used, or there is any character sllying in the 
Apple Guide source file. Since you must have Guide Maker Lite 
to compile AG Author output into an Apple Guide document, 
you must have Guide Maker Lite before you can create a guide 
file with AG Author. Use the links at Lakewood Software's or 
guide Works's sites to get Guide Maker Lite and Claris XTND. AG 
Author could have simplified things for first Lime Apple Guide 
authors had they provided Guide Maker Lite and the Claris 
XTND system as part of the distribution package* 

The download also does not include Apple Guide, but alt 
systems shipped since 7,5 have the necessary software. Users 
with System 7,0 or 7 1 require Apple Guide 2,0 or newer. 
Subscribers to Apple's \MacOS SDK,” already have a license to 
ship Apple Guide with their products. The SDK contains Lhe 
latest version of Apple Guide and all the pieces necessary for 
installing Apple Guide on System 7.0 and newer, if your user 
has System 7.5 or newer, you do not need to ship Apple Guide 
with your product, 

AG Author requires a minimum of a 68020 processor, MacOS 
7.0, 8 MB of RAM, and 5 MB of disk space. The AG Author 
documentation recommends a PowerPC processor. The download 
Includes PowerPC and 68K versions. 

Documentation 

The included Read Me includes important notices, technical 
support and contact information, quick start instructions for 
experienced Apple Guide developers, and version history. 

The product also includes a 64-page on-screen “User 
Guide.” The document contains step-by-step and reference 
information about every aspect of AG Author It is a gtxxl 
reference document, but assumes you already know a great deal 
about Apple Guide, If you are new to Apple Guide authoring, 
you will also need one of the three Apple Guide books, (A list 
of lxx)k,s and articles are at the end of this article.) Ironically, AG 
Author does not ship with an Apple Guide because the 


John Powers was the software architect and lead engineer for Apple Guide, Currently, he and Ills associates at guide Works 
create help content anti do software engineering and localization for Apple Guide. Windows Help, NetHelp, and HTML Help, 
You can contact him at powers® guide works, com. The guide Works weh site is hup :/Avww .guideworks com. 
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TCP/IP Scripting Addition The Internet Scripting Solution 


The TCP/IP Scripting Addition allows you to quickly 
develop Internet client/server applications using 
AppleScript®. If you want to script with MacTCP ™ and 
Open Transport™, here's your solution! 

♦ Supports Script Editor, FaccSpan™, and HyperCard 1M 

♦ Build net-wise WcbSTAR™ CGI scripts 
and NetScape™ CCI scripts 

♦ Sample scripts include FTP, Gopher, 

Telnet, Post Office, E-Mail and more 

♦ Featured on the Apple® Internet Server 

Order now through the MacTech Mail Order Store at 
80S—494-9797 or other mail order stores 



if 


Mango Tree Software, Inc. 

Box 1057 ■ Brookline, Massachusetts 02146 
617-327-8663 

http: //www. rn a n gotree. eoi t Vbiz/ima ngo 


All ir [ *defli<jrk& art? proportic** of iheir respet ti\e holders. 

Coinat \ Mango Tree Software for sile licensing and nxlhiribuiion in forma I ion, 
Co|>yright © Mango Tree Software, Inc. 


FTP Parameters 


Set these paran 
(sending) files I 


FTP Host 
Directory 


Telnet Libre 


V/€ 


User ID 
Password 


m; 


Type of file trai 

O MacBinary File 


'W Description: 


Telnet Library vl.0 

Copyright © 1995 Mango Tree 
All Rights Reserved 




Record Stpp 


Run 


set my_tel net—stream to teln< 
tell my_telnet^stream 

try 

connect(your_host) 
read until text("loc 


development t<x>l used to create AG Author does not support it 
This is unfortunate because an Apple Guide for AG Author would 
be enormously helpful, 

Authoring steps 

The User Guide describes a seven-step process for using AG 
Author to develop Apple Guide content The steps are as follows: 

1. Plan the guide file project, 

2. Specify the project global#, 

3. Build the topic and index lists, 

4. Build the definition library, 

3, Write the panel and sequence scripts, 

6. Compile the guide file, and 

7. Test the guide File. 

Th is is the sit me process used by other Apple Guide authoring 
tools (Powers, 1996) with the addition of step 4, building the 
definition library. As a point of reference, other authoring tools 
either require the writing of Guide Script (Guide Maker) or 
insulate the user from writing Guide Script (Danny Goodman's 
Apple Guide Starter Kit anti Guide Composer). AG Author writes 
and displays the Guide Script automatically. 


Using AG Author 

Step I. Plan the guide file project 

This step is the first step in any documentation project, no 
matter what authoring tool you are using. It includes defining 
the target user and the scope of the help content, and 
performing a task analysis. This all-important step does not 
require AG Author, 

Step 2, Specify the project globals 

Project globals information applies to the entire guide file. 
Examples are the rype of access window, the howdy text, default 
formats, the help menu item, and prompts. Use the Project 
Globals dialog box to enter this information. A WYSIWYG 
interface makes it easy to see what how the information will 
appear in the guide. 



Figure /, Project Globals dialog box. 
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AppMaker supports most popular languages 
and frameworks. Just point and click to design your 
user interface, then let AppMaker create resources 
and generate ‘human, professional quality code” 
to implement your design. 

Use AppMaker as a prototyping and 
productivity tool or use it as a learning tool 
for Mac programming techniques or 
for new environments such as 
OpenDoc, Java, or Pow'erPIant. 

AppMaker is just $299 and includes a 
one-vear subscription on CD. 

B • O • W • E • R • S 
Development 

603 - 863-0945 

bowersdev@aoLcom 

http://members,aoLcom/bowersdev 


Step 3. Build the topic and index lists 

The AG Author List Manager defines die contents of the Apple 
Guide access window. Topic areas, index terms, headers, and topic 
names are entered into a window that looks a lot like the Apple 
Guide access window with a few extras. Each list starrs with one 
"Undefined* item. If you have done step 1, the plan, thoroughly, it 
is a simple task to add the topic areas to the access window, AG 
Author provides a lot of flexibility in how to enter infbmiation. For 
example, you can enter all the topic areas and then go back and 
enter topics Tor each, or you am do one topic area at a lime, 
entering all its topics. Enter, modify, move, and delete items by 
selecting it and clicking on the appropriate button. This is similar to 
Apple Guide Starter Kit and Guide Composer. 

To enter a topic, select the topic area and use the New 
button to create each header and topic. A triangular marker 
shows the insertion point for the next topic area or topic. If 
you build your list from the bottom up, then entries come out 
in order. Otherwise, you must move the marker down before 
entering each new list item. When you switch between the 
topic areas, the marker is reset to the top of the list. If you gel 
an item out of order, you can move the item to its proper 
location using Option-drag. 



Index terms are added using the List Manager Index 
view. The process is very similar to creating topic areas and 
topics in the List Manager Topics view. Often, you may want 
to enter an index term and use a header or topic from the 
Topics view. However, AG Author only lets you copy and 
paste entire topic lisis from the Ust Manager Topics View, not 
individual topics. You must either build the index from 
scratch, re entering all the headers and topics for each index 
term, or copy a complete topic list and delete the unwanted 
topics. Also, there is no automatic generation of index terms 
to “seed” the list. It would be nice to start with the words 
used to describe the topics, for example, for a head-start with 
the index list. Guide Composer is the only authoring tool that 
offers automatic seeding of the index list. 
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Distribute Your Software 
Electronically and Get Paid! 


PACE Software authorization systems let you: 

• Create fully functional time- or launch-limited “trialware” 
without changing your source code 

• Distribute via the Internet, CD-ROM, BBS, floppies and more 

• Unlock software with flexibility and security 

• Add registration-capture to your software without writing code 

• Integrate registration and authorization with popular web servers 



PACE 


ANTI-PIRACY 


To sample the customer experience, download our 
demo from www.paceap.com. It's easy, and it's free! 

Want to try out our system on your software? Call 408/297-7444 
or send email to sales@paceap.com to order our evaluation kit. 


1082 Glen Echo Ave 
San Jose, CA 95125 
vox: (408) 297-7444 
fax: (408) 297-7441 
email: info@paceap.com 
web: www.paceap.com 


Step 4- Build the definition library 

AG Author Definition Factory builds the definition library- 
The definition library contains sequences (topics), panels, 
formats, graphics, eoaehmarks, and other items used in an 
Apple Guide file. You create an dement once and refer to it 
from many places. It is a useful way to create and manage the 
many elements of a guide file. None of the other authoring 
tools offer anything similar. 

The New Sequence dialog fx>\ lias entries for sequence name, 
the title to appear on each panel of the sequence, the pionipi seL, 
and the navigation button set. Unfortunately the New Sequence 
dialog box is a nonmoveable modal dialog box that positions itself 
in the middle of the monitor, covering other documents. The dialog 
l)ox displays a default prompt set and navigation button set. You can 
also elect to have an ID number pre-defined for the sequence. This 
is a handy option if your application uses the 
AGQpenWirhSequencc Toolbox call to open the sequence tor you. 
For example, you can use a Help button in your application to call 
up the sequence directly. The application passes the pie-defined ID 
number in the AGOpenWithSequence call to identify which 
sequence to open. See Powers, l f )94 for more information on how 
to use this context-sensitive feature of Apple Guide. 



Figure j. New Sequence dialog box. 


When you create a new sequence, AG Author displays the 
Script Editor window containing the Guide Script for the 
sequence. The script includes a completed sequence name and 
display name. You can enter Guide Script directly or use 
popups to insert panels, control structures, and navigation 
statements. If you do enter Guide Script directly, AG Author 
does not add it to the definition library. For example, if you 
enter a “Panel* or “Define Panel" command in the Guide Script, 
AG Author does not add the panel to the definition library. The 
best approach is to use the popups and let AG Author generate 
the Guide Script for you. The Apple Guide Starter Kit and 
Guide Composer create Guide Script loo, but they do not 
display ii for the author. ITiis is not necessarily a shortcoming 
as we will see below. 
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Buffer and File Compression Win! 6 $299 
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Disk Spanning OS/2 $349 

Encryption Unix $349 
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On-line Help 

Full C Source Code FREE DEMO 
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ns n r y* Fax 606-245-9305 

Effl DC Micro info@dcmicro.com 

CS Development hHp;//www.dcmicro.com 

Call 1-800-775-1073 




The Insert Panel popup brings up a list of defined panels. If 
you have not defined the panel, you can Option-click the button 
and create a new panel. 



Figure 4 . Script Editor fora sequence 

The New Panel dialog box lets you select from a list of 
templates. The templates contain formatting and prompt 
information for the standard types of Apple Guide panels. The 
panel types include introductions, actions, definitions, tips, 
and many uLhers. This is a very nice feature of AG Author. It 
provides a quick and consistent way to present the standard 
forms of help content. 



Figure 5* New Panel dialog box. 


When you create the new panel, AG Author displays the 
Script Editor window. In this context, the window shows the 
script for a panel rather than a sequence and includes popups 
for panel Insert, Button, and On Panel items, AG Author also 
highlights the area where you need to enter your own content. 



Figure 6l Script Editor for an introductory panel 

To create a “Do This” panel for example, Lite author 
clicks New in the definition factory panel list and selects the 
Action template. The script editor appears with the 
appropriate tag and body formats already entered. To add a 
u Do It For Me" button in the panel, the Button popup is used. 
If you have not defined any buttons yei t you need to go back 
to the definition factory and define a '“3D” button that 
executes an AppleScript If you are not very familiar with this 
Apple Guide button capability, then the button definition 
dialog box will appear overwhelming ai first. This is one of 
the places where AG Author needs Apple Guide, a better 
interface, and/or better documentation. 



Figure 7 Button Definition dialog box , 

When you click New in the definition factory panel list, the 
New Panel dialog box appears with the panel name already 
entered and changed from “‘Step 1" to "Step 2", 'this feature of 
AG Author simplifies the creation of a series of step panels. 
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To create a coachmark, the author Option-clicks the 
Coachmark item in the script editor Insert popup for the panel. 
The Coachmark Definition window has all the fields necessary for 
defining the coachmark including a file selection dialog fx>x to 
select the target application signature. 



Figure R Coachmark Definition dialog />ar 

It is easy to create additional coachmarks by duplicating the 
first coachmark and changing a few parameters. 

Step 5* Write the panel and sequence scripts 

After defining all the panels for the sequence, the script 
editor is used to add the panels to the sequence. To do this, die 
author opens the sequence and selects the panel title from a list. 
This adds a panel reference in the Guide Script for die sequence. 



Figure 9. Script Editor for a sequence with panels , 


One script editor window displays the script for either 
panels or sequences, but not both at the same time, a 
shortcoming of AG Author. Fortunately, the script editor contains 
pop-ups for the Len most recent sequences and panels. 

Context checks make rhtt guide file “intelligently" responsive 
to the user's actions. Context checks skip unnecessary panels and 
check to see that a step is completed before going on. For 
example, if a window is already open, the context check skips 
the panel telling the user to open the panel. The definition 
factory has a dialog box for defining context checks, but it 
requires detailed knowledge of Apple Guide to use. Again, this 
is a good place for some interactive assistance from AG Author* 
a letter designed interface, and/or better documentation. 
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It’s Macintosh Accounting At Its Best 



Flex Ware is designed 
to give you almost 
unlimited possibilities 
as your company 
grows. 



FI ex Ware’s accounting 
features and reporting 
capabilities give you 
information you'll 
rely on daily to make 
smart decisions. 



ge businesses eons is 
tently choose Rex Ware 
because of its exceptional 
speed on network and 
client/server systems. 


Meet your clients’ needs with the FlexWare Development 
System, Hex Ware is an integrated, modular, MacUser Recommends 
award-winning accounting program that you can modify and 
customize to suit each of your clients’ requirements. Take advan¬ 
tage of FlexWare’s top performance and adaptability. It’s llexible. 
It’s powerful. It’s fast. Call the Flex Ware Sales Department at 
888-353-9927 for information on the FlexWarc Development System. 


FlexWare 


ACCOUNTING 



3715 Atherton Rd. #1000 Rocklin, CA 95765 -888/353-9927 - FAX 916/624-0757 
email : $ate$@flexware.com. http://wwwdlexware.com 



Figure 10 : Context Check Definition dialog box. 

After creating a context check, select the sequence and add the 
control structure. Use the popup* to select ihe control structure 
("Skip IT and 'Make Sunt*"). However, a knowledge of Guide Scrip! 
b necessary to know where to insert the control structure. 



Figure IF Serifn Editor for a sequence 
with panels ami context checks. 

Step 6. Compile the guide file 

The “Compile" step involves two major operations. First, 
the project Ls exported into Guide Script files. Next, an Apple 
Guide “guide" file is created from the Guide Script. AG Author 
does the export and Guide Maker Lite creates the guide file. The 
step starts with choosing Compile Project from the AG Author 
File menu, A dialog box appears to show the progress through 
each step in the process. 
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Figure 12. Compile progress dialog box , 

My first attempt at compiling a project failed; AG Author did 
not complete all the compilation steps. IE exported all the Guide 
Script files, brought Guide Maker Lite to the from, but stopped 
prematurely. 1 re-read the User’s Guide to make sure l installed the 
software correctly. 1 also reviewed the instructions for setting up 
the compile preferences and starting the compile. Finally, 1 called 
the AG Author customer support number and asked for their help. 
They walked me through the compile process and duplicated ii at 
their end. They asked some good questions alniut my 
configuration, leading me to suspect my copy of Guide Maker Life. 
Replacing Guide Maker Lite solved the problem, 

My first compilation reported an error. Guide Maker Lite did 
not recognize the name of a panel. 1 had changed the panel name 
in the definition factory panels list, expecting AG Author to 
change the panel name in the Guide Script for me, but a didn't* To 
correct Lhe problem, 1 used AG Author’s Find & Replace to find the 
old panel name and replace it with the new one. 

You must keep the Guide Script in synchronization with the 
definition factory. Otherwise, compilation errors will occur. If you 
make a change to an object's definition, then you must also make 
the corresponding change in the Guide Script. If you make a 
change in the Guide Script, then you must also make the 
corresponding change in the definition* AG Author does not do 
tills automatically. You can use Find & Replace to do part of the job, 
but not all of it. AG Author has elected to 'expose" Guide Script to 
the user in a passive way. Once the Guide Script is presented to the 
user, it's entirely up to the user to maintain it. This introduces the 
risk of the user breaking the Guide Script and introducing compiler 
errors which may be difficult to trac k down. This is a trap that new 
user should avoid unLil they become more comfortable with Guide 
Script, You can use the Lock Scripts option to give some degree of 
protection against this. 
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Figure 1J. Compiled guide file . 


The professional web page development tool 

• Award winning spell checker 

• True, continuously updated, WYSIWYG preview 
» Tables (creating, editing, and importing) 

• Limited site management 

• Forms 

• Page colors &U*t9*T 

• Frames WWCd Bjliw ”1 

• Text and styled text importing 

• Add your own tags 

• Very customizable 

• Preview with different browsers ' 

• Includes two free upgrades 


d importing) 

WoM Wide 

Wei 


SI!S 



Mac User, August 1996 


• Check/Edit/Updale all of your links on your site on seconds! 

• LI plead pages and siles directly to lhe web 

•Work offline and then lei Site Weaver™ synchronize your work later 

• Easy Mac interface for novices or full lime professionals 

• Works with just about any graphies/plugdn program, page editor 4 and 
web browser 


For the latest ordering information point your web browser to 
http://www.Miraclelnc.com or call (315) 265-0930. 


AG Author creates Guide Script texi files for the compilation 
by Guide Maker Lite, and exports the project as multiple text files, 
resource files, and pict files. The user does not have to touch these 
files. The text files contain the Guide Script for the project. A build 
file contains references to the text and resource files for Guide 
Maker Lite, AG Author generates well-organized and well- 
commented Guide Script. 


Conclusions 

AG Author delivers all die features of Apple Guide wrapped 
up in a friendly and useful tiser interface. It requires knowledge 
of Guide Script, but it does not require the user to be an advanced 
scriptcr to create useful guides. Some kind of step-by-step 
assistance in using AG Author would make the product much 
easier to use. There are several areas, outlined in the article, 
where documentation change and/or change in basic architecture 
would benefit the product* 

AG Author is the next step in the evolution of Apple Guide 
authoring tools. This is a good product, but it has some 
weaknesses. While it adds a lot more authoring capability, it does 
not go far enough in providing the ease-of-use to support that 
capability, lhe product has numerous features that arc buried in 
the documentation and user interface. The new or occasional 
user will realize the full potential of the product only after a great 
deal of hands on experience. To the positive, it docs help those 
authors that need more capability without requiring them to go 


Junk 1997 * MacTech 


AG Airman 


33 


















































Books 

The following are books about Apple Guide authoring. 

1. Apple Computer, Inc, "Apple Guide Complete: Designing and 
Developing Onscreen Assistance”. Addison-Westey (ISBN 0- 
201483343} $39 95 (ITS.) 

2. Feiler, Jesse. "Real World Apple Guide”, M&T Books, ISBN 1- 
55851-429-5, $39,95 (U.5.) 

3. Goodman, Danny and Ilewes, Jeremy Joan. “Danny 
Goodman's Apple Guide Starter Kit”. Addison-Wesley 
Publishing (ISBN 020148349-1) $34.95 (U.S.) 

Articles 

The following arc articles alx)Ut Apple Guide authoring. 

1. Powers, John, “Giving Users Help With Apple Guide”, develop 
(June 1994, issue 18). This article introduces Apple Guide and 
describes how to add Apple Guide support to an application. 

2. Powers, John. “New Apple Guide Authoring Aids”. MacTech 
Magazine (January 1996, Volume 12, No. 1). This article 
reviews three books about Apple Guide authoring: Apple 
Guide Complete, Danny Goodman s Apple Guide Starter Kit, 
and Real World Apple Guide. 

3. Powers, John. “Apple Guide Authoring Tools", MacTech 
Magazine (June 1996, Volume 12, No. 6). This article reviews 3 
Apple Guide authoring ttx>ls: Guide Maker, Danny Goodman’s 
Apple Guide Starter Kit software, and Guide Composer. 

Internet Resources 

The following are Apple Guide resources on the internet. 

1. <http://www.guideworks.com> — everything you need to know 
about Apple Guide including demos of authoring tools, 
frequently asked questions, tips, and links to other sites. 

2. <http://wwwJakewoodsoftwarexom> — the home site for AG 
Author. Provides information about the product, a demo that 
you can download, and ordering information. 

3. <http://www.macos,com/Apple_6uide/> — Apple’s site for 
Apple Guide. 

4. <http://www.dannyg.com/> — Danny Goodman's site. 

5. <http://rampages.onrannp,net/-stepup/> — StepUp Software’s site. 

Thanks 

Ihe author thanks Marc Paquette, Document Bard at 

Metromrks, Inc., for hit help in preparing this article . ®1 


web site at <http://www.lakewoodsoftware.com>. 


Visit MacTech® Magazine’s Web site! 

http://www.mactech.com 



MkLinu 

Microkernel Linux for the Power Macintosh 


Why wait for Rhapsody? MkLinux is a complete system, 
based on Linux 2 and the Mach 3 microkernel. It includes a 
complete software development system (gcc, gdb, perl, 
X11R6.3, and hundreds of other commands. Get MkLinux 
and start working right now with Mach, Objective-C, UNIX 
development tools, and more... 

MkLinux builds and runs most Intel-based Linux sof tware. 
It works efficiently and reliably on a wide range of Power 
Macintosh platforms, with other ports on the way. MkLinux 
has an active user community and a substantial Reference 
Release, both sponsored by Apple Computer, If you want to 
get a jump start on Rhapsody, this is a great way to do it! 

Visit Apple's MkLinux web site (www.mklinux.applc.com) 
and Prime Time Freeware’s web site (www.ptf.com) to find 
out more about MkLinux and other fine freeware products. 


Prime Time Freeware 
370 Aftair Way, #150 
Sunnyvale, CA 94086 


info@ptf.com 
(408) 433-9662 
(408) 433-0727 fax 


entirely to Guide Script. It holds its own nicely with the 
competition, but is not the hands-down winner. 

Here are some suggestions for different types of authors: 

• If you want the easiest way to try out Apple Guide, buy Danny 
Goodman's book (Goodman and Hewes, 1995). Read it and 
write a guide using die software provided with Danny’s book. 

• if you want to use most of the features of Apple Guide and 
avoid Guide Script, use StepUp Software’s Guide Composer. 

• If you want to use all the capability of Apple Guide and are 
willing to learn some Guide Script, use AG Author, AG 
Author is also the only product that lets you style text without 
a word processor. 

Overall, AG Author provides a new level of capability and 
ease for authoring Apple Guide files. 

Availability 

AG Author retails for $99*00 U.S, Educational and site 
licenses are available. AG AuLhor is available only from 
Lakewood Software’s web site. A compile-disabled version is 
available for download from Lakewood Software's web site for 
free. You can evaluate the compile-disabled version at no charge 
and, when you want change it into a fully enabled version, 
obtain a registration number from Lakewood Software, 
Complete information is available at the Lakewood Software 
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LOOK & FEEL 


by Jeff Beegbly 


Adding 3D Controls to your System 7 App 


Custom controls can be 
used to provide Apple's 
Grayscale Appearance for 
System 7 applications 


Introduction 

Applications containing 30 controls are 
becoming the standard in the computer 
industry. Users and developers prefer 
applications which contain a *30 object" look 
and fed. For some time now, developers have 
been implementing their own version of 
controls. The intent of this article is to 
demonstrate how to effortlessly transform an 
application from the standard 2D appearance 
into a 3D appearance. 

Transforming Dialogs 
into the 3D World 

By following these simple steps, you 
can transform your dialog boxes and give 
them a new *3D look and feel": 

1. Add 3D Buttons CDERrsrc to your 
project. Tills file is in the source code 
package which accompanies this article, 

2. Change the content color of every dialog 
box (and alert lx>x) within your projects' 
resource from white to gray. If you're 
using ResEdit, this is accomplished by 
opening a DLOG resource, changing the 
color from Default to Custom and changing 
the content color to light gray (Figure 1), 



Figure L Selling lbe Content Color to Gray Within ResEdit. 


If you Ye using Resorcerer, this is accomplished by opening a 
DLOG resource, selecting the Set Dialog Info,,, menu item, 
selecting the Window Color Content item, then setting each of 
the RGB values to “>6797 (OxDDDD Hex), 
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Figure Z Setting the Content Color to Gray Within Resorcerer 


Jeff Beeghly is a contract programmer and has been developing software for the Macintosh for several years. His specialties are 
in creating user interfaces, MIDI applications, and image processing applications. You can reach him at sd@compumedia.com or 
jefLbeeghly® dbug ,org. 
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3. Every edit text item within the dialog box must have its 
background color set co white, Ihis is accomplished by 
creating a dialog item list color table Cictb') resource for each 
dialog. If you’re using ResEdil you will have to create an lab’ 
resource that has the same ID as the THXL * 1 resource you are 
working with. ResEdit does not have an lab 1 editor, so you 
will have to assemble one by hand using ResEdit’s Hex editor. 
Eor more information on the J ictLV resource and its' format, 
please consult The Item Color Table Resource" within Inside 
Macintosh: Toolbox Essentials, or consult the “NewCDialog" 
topic within THINK Reference. 

If you’re using Resorcerer, you will need to select the edii text 
item, then select the Color and Text Styles,., menu item (which 
will bring up the Color and Text Styles dialog box). Since the 
default background color is white, the only thing you need to 
do here is select the Backed or checkbox. 



Figure J Setting the background color of 
an edit text item within Resorcerer, 

4 Add Update3DDia(ogx to your project 
5- In each dialog of your application, there should be a modal 
dialog filter. Within each filter, add the function 
Update3DDialog{) lo the update switch (Listing I ) and include 
UpdateSDDialog.h within the source code. 


DrawDefaultButtonOutlineCpThcDiaiog, QJLiTEM); 
iiPic - GetPicture(USER_FIC_ID); 

GetD Item.[pTheDia1o&, USER ITEM. tnType. 
trltera): 

DrawPicturefhPir., fcr I tern) ; 

// Add this ftinction 

UpdateiDOialog(pTbeDialog); 

EndUpdate(pTheDialog): 

SetPort(pOldPort): 

I 

break; 


6. Recompile and run your application. 

What could be simpler? 

What’s Going on in There? 

The CDEF that was added to the project is a modified version 
of the 3D Buttons CDEF vL08 written by Zig Zichterman (located at 
<http;//www + bestxonn/-ziggr/> as well as many InfoMac and UMTCH 
ftp mirrors). Ry adding the 3D Buttons CDEF and giving it a 
resource ID of 0 f the standard system controls (which are contained 
within the System's CDEF 0) are replaced with the 3D Buttons CDEF 
when the application is launched. The standard push button, radio 
button, and check Sx)x now contain the new 3D appearance 
(Figure 4). Please note that the standard controls will only be 
modified far your application, not system-wide. If you switch to 
other applications while your application is running, you will notice 
that the other applications still contain the standard system controls 
they had before. 


[ Push Button ] 

O Radio Button 
□ CheckboH 


Figure 4. 3D Push Button, 

3D Radio Button, and 3D Check Box. 


Listing i: ExamplrDialnf’Pft>c 

// Add this indmte 

^include M UpdaLc3DDialogJr 

pascal Boolean ExampIeDialagProc(DialogPtr pTheDialo&, 
EventRecord ’pTheEvent. short ’pnltem) 
t 

WindnvPtr pWindow; 

GrafPir pGldPort: 

short nType; 

Handle hitem: 

Rect rltem; 

switch( pTheEventDwhat ) 

I 

case updaroEvt: 

pWindow - (WindowFtr IpThcEvent >message; 
if(pWindaw ™ (WindowFtr )pTheBialog) 

i 

GetPort(SpOXdFort); 

SetFnrt(pTheDialog); 

Begi nOpdatefpTheDtal o&): 

Updatebialog(pTheBUlo&, pTheDlalog >visRgn): 


Our CDEF is also very intelligent; it knows when it should be 
drawn in 313 and when it should be drawn in 213. When the 
control is drawn, it checks for the following three conditions: 

* Does the machine have color Quickdraw? 

* Is the G Device in which the control will lie drawn set to at least 
256 colors? 

* Does the dialog box have a colored background? 

If all three conditions are met, the control is drawn in 3D, 
otherwise the standard 2D control is drawn. Using this 
convention, dialog boxes only appear in 3D when specifically 
intended to be that way. 

When wouldn't you want dialogs to look 3D? While working 
on a recent project I noticed a discrepancy within the 
Standard PutFile dialog box. Every control contained the 3D 
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appearance except the New Folder button. This control is not a 
standard control and is not overwritten by the added CDKF. In this 
situation, consistency is more important than having a 3D 
appearance, so the dialog was left with its original 2D appearance. 

Why Not Usf the Original 3D Buttons CDEF? 

The original 3D Buttons CDEF is modeled after the 
suggested 3D style guide described in the article, “Working in the 
Third Dimension" which appeared in the September 1993 issue of 
develop (Issue 15). Since the publication of tills article, Apple has 
released a document titled "Apple Grayscale Appearance For 
System 7.5," located at 

<ftp ://ftpde v. i nfo.appl exom/De ve I ope r_5e rvices/Te chn ica l_ Docu mentation/H u 
ma n_Interf ace/Apple_Grayscale_Appearance.sit. hqx>. The new version of 
the CDEF incorporates the new Apple Grayscale Appearance 
guidelines, separates die push button CDEF from the standard 
controls CDEF fixes two bugs that were in the original 1.08 code, 
and includes several project-wide *ifdcfs. 

The project was also converted from C++ to C. By converting 
the source from C++ to Q I was able to take out redundant code, 
redundant axle paths, and eliminate a lot of overhead that's 
inherent with C++. I analyzed the performance of the drawing of 
the CDEFs and found that the C version of the push button was 
30% faster then the C++ version, and the C version of the icon 
button was 67% faster then the C++ version. An added benefit is 


that the si 2 e of the C CDEFs are smaller than the size (if the C++ 
versions. 'Die downside is that the C version isn’t as readable as 
the C++ version. For more detailed information on the changes 
that were made, please consult the Read Me file within the 3D 
Plug&Play:3D CDEFs / folder. 

Example ! 

Example 1 is a simple dialog demonstrating a little bit of 
everything. Each of the tlirce button styles are represented and the 
example also displays the buttons in their disabled stale. If you 
observe the edit text item and rhe list Ixix item, you will notice that 
both ilems contain a 3D rim (Figure 5) 'Hie rim has been added 
to give die appearance of depth to each object. The rim is drawn 
with the Update3DDialog routine, which parses the DILT of a 
dialog. The current incarnation of Update3DDialog looks at each 
item widiin the DITL list, and draws the rim if the item is an 
editText, picltem, or userltem. 


Visit MacTech Magazine’s Web site! 

http://www.mactech.com 
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List item 0 


List item 1 

_ 

List item 2 


List item 3 

l\}\Q 

List item 4 

i*;*w 

List item 5 


List item 6 

O 


Figure 5* 3D Rim Around a List Box , 


Example 2 

One of the purposes of this article is to provide developers an 
effortless (or near effortless) way to give their dialog lx>xes a 3D 
look and feel. To ensure that the routines would be widely usable 
and not dependent on my methodology or style, i added the 
routines to several different building blocks. 1 used TransSkeFs 
DialogSkel example, Metrowerk’s CDialogsApp PowerPlant 
example, a Resorcerer-generated dialog, and a code snippet called 
Dim Text, 

The easiest example to convert was the TranxSkd example 
which required only the added files and modifications listed 
before. The PowerPlant example was very simple as well, 
however it is not complete. The PowerPlant example creates 
windows instead of dialog boxes and 'DlTh resources, su my 
Update3DDialog routine was useless in this case. Rather than 
write a class that overrides any of the PowerPlant c lasses (which 
has a high chance of conflicting with the other classes), this has 
I >cen left as an exercise for the reader, 

'Flic Resorcerer example was also easy to convert, except 1 
had to create an unique version of Update3DDialog 
(Update3DDialog-Re.sorcerer + c), Resorcerer uses user items to 
display group boxes, and the original update routine draws a 3D 
rim around user items. Dim Text was also easy to convert, 
however, some minor modifications were required. For more 
information on the changes made to each of these projects, 
please consult the notes file located within each project’s folder. 

Example 3 

Example 3 is an expansion of Example L Within Example 
3 you may open a 3D or 2D dialog box. Some users may not 
prefer to have 3D buttons (or may choose their own interface 
with Mac OS 8) + Within the Example 3 application is a 
preferences dialog. The sole purpose of this dialog box is to 
change the appearance of the controls from 3D to 2D and back. 
This is accomplished by using Get 1 Resource and Set Res Info to 
move the 30 CORE resource out (and back into) the CDEF 0 
location, and changing the background color of DITL and 


WIND resources. When the CDEF is not in the 0 location, the 
standard controls that are built into the System are used instead 
of our custom CDEE This technique allows the user to decide 
upon the appearance of the application. 

This technique also allows the application to be compatible 
with MacGS 8. As stated earlier, the application achieves its 3D 
look by overriding the standard CDEF 0 that is built into the 
system. By this same convention, it will probably override any 
appearance setting Lhe user has set with the Appearance Manager 
in MacOS 8. By providing this mechanism, the user has the ability 
to use the advance controls with the current system, and use 
MacOS 8\s customizable controls when it is released. 

Example 4 

Example 4 demonstrates what you can achieve when you use 
3D controls. The example not only incorporates the 3D controls 
demonstrated earlier, it also contains an Icon button. Group Box, 
and a Plus/Minus (Spindial) CDEF, all of which can be displayed 
in 3D (Figure 6) or 2D. 


30 Oial&g Example 

Ln allied 
® Check BfiH 1 
$ Radio Button 1 
Q Radio Button 2 
Q Radio Button 3 


12 


Disabled 

□ flunk Rim ? 

® Dii(Hu Tuition 4 
Qjmmo Dutton s:: 
o Bnilio Hull on fy : 



| Cantel ] 



Figure 6, 3D Buttons CDEF along with Icon button, 

Group Bax, and Fius/Minus CDEFs. 

In addition to this dialog box. Example i also contains dialog 
boxes which focus on the different kinds of Group Box, 
Plus/Minus, and Icon Button variations that are available. Of 
special importance is the Icon Button CDEE Developers are 
increasingly incorporating tool pallets within their applications. 
Within these tool palettes are usually a large number of icon 
buttons. The behavior of icon buttons typically act as push 
buttons, yet some icon buttons may act as checkboxes (like 
Microsoft Word’s text alignment buttons) or radio buttons (like 
Photoshop’s Tool palette). 

While working on the code for Example Ts Icon Button 
dialog, 1 noticed that the icon buttons that were intended to act as 
checkboxes or radio buttons produced a flickering effect. The 
problem is when die control is selected and the mouse button is 
released, the control is sent a redraw message from the system, 
and Lite control is drawn in the off position. The code within the 
application then changed die value of die control and displayed 
the control in a selected position ( Figure 7). 
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International shipping (US Airmail) $10 
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Figure 7 Flicker Producing Drawing Process. 


To overcome the unwanted flicker, 1 added code within the 
CDEF to handle this special rase and f added a new variation 
number to die Icon Button CDEF. Use variation 3 for a push button 
style icon button, and variation 4 for a checkbox or radio button 
Style icon button. For example, if the ID of the Icon Button CDEF 
is 1101, the PnxdD of a push button style icon button is 17619 
(1101 * 16 + 3 = 17619) and 17620 for a checkbox or radio button 
style icon button (1101 * 16 + 4 = 17620). 

CONCIXBION 

What his been demonstrated here is just the tip of the 
iceberg. There is plenty of room for development of more 3D 
controls. There is also room for implementing user interface 
elements that are controlled by the user. For example, the 
Preferences dialog could noL only relocate the 3D Buttons CDEF, 
it could change die background color of each dialog and alert 
back and forth between white and gray, 


For More Information 

If you are interested in developing CDFFs, Fd suggest die 
following materials: 


1. 3D Buttons CDEF, by Zig Zichterman, located on 
<http://www.best.com/~ziggr/>. 

2. CDEF Template, by Chris Larson, located on 
<ftp://mirrors.apple.com/mirrors/info-nnac/dev/src/cdef-tempiate-10.hqx>. 

3. Jim's CDEFs, by Jim Stout, located on 

<ftp://mirrors.appie.com/rnirrors/infD-mac/dev/lib/jims-cdefs-15.hqx>. 

4. A Fragment of Your Imagination, by Joe Zobkiw, Adison- 
Wesley 

5. More Mac Programming Technique s f by Dan Sydow. M&T 
Books BQ 


Want to share a tip with the 
community and get paid for it? 
Send it in to 

<mailto:tips@mactech.com> 
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by Michael Fanning, Microsoft 


ActiveX Controls for Macintosh 


Microsoft’s next 
generation of content-rich 
web page development 

Welcome 

Macintosh ActiveX is Microsoft's native 
implementation of ActiveX controls for the 
Macintosh platform, A “control' 1 can be 
loosely defined as a next-generation plug¬ 
in technology for Web browsers such as 
Microsoft's Internet Explorer, Netscape 
Navigator, and (soon) Apple's Cyberdog 
browser part. Controls can also be used to 
quickly add specialized functionality to 
desktop applications and development 
tools in addition to Web sites. Mac ActiveX 
provides a powerful environment for 
developing interactive and content-rich 
Web pages, ActiveX on the Macintosh 
retains much of the ActiveX programming 
model on the Win32 platform and most 
features; there are, not surprisingly, some 
important architectural differences. 

Mac ActiveX is built on the 
Component Object Model (COM), a 
simple object model that provides 
mechanisms for object instantiation, object 
querying and object reference counting (a 
means of controlling object usage St 
lifetime). COM interfaces allow for flexible 
object design and are semantically 
equivalent to Java Interfaces (for a 
definition of COM interfaces, see die 
beginning of the 'Architectural Overview' 


section at the end of this article), Macintosh ActiveX is based on 
a lightweight COM library which has been optimized for in- 
process controls. These services allow ActiveX controls to work 
seamlessly within a browser rather than as separate processes. 

Other advanced features of Mac ActiveX make the 
experience of ActiveX controls more seamless than plug-ins. 
Transparent download, for example, permits a control to be 
downloaded, installed, and activated in a Web page without 
requiring the browser to be restarted or that the user go through 
any installation procedure. 

This article presents a general architectural overview of 
Mac ActiveX and a detailed description of its software 
development kit. The last half discusses the mechanics of 
building and running ActiveX controls and details a simple 
modification of an SDK sample in order to create a new, custom 
control. Much of the information here appears in rwo essential 
SDK documents, the ActiveX User's Guide and ActiveX 
Technical Guide. There are pointers to additional SDK 
documents and other references where topics to which I refer 
are beyond the scope of this article. I’ve included definitions of 
some important, basic terms and concepts as they appear for 
anyone who might be encountering them for the first time. 

The final section of the article contains important information 
on obtaining technical support from Microsoft for developing 
ActiveX controls on the Macintosh. 

ActiveX and Java 

ActiveX and Java are complementary, nor competing 
technologies. First and foremost, Java is a programming language. 
Second, Java is a set of virtual machine bytecodes that can be 
executed on any platform running a Java Virtual Machine (VM), 
Third, Java is a set of programming interlaces that define the 
underlying services available from Java code. 

ActiveX, on the other hand, provides a totally different set of 
benefits focused on integrating objects created in Metrowerks' 


Michael Fanning ts Microsoft’s Developer Support liaison for ActiveX/OLE for Macintosh and an enthusiastic proponent of the 
Component Object Model and ActiveX controls. 
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Code Warrior environment with Web pages. ActiveX controls are 
native Mac applications and can be written using any of the rich 
MacOS services available through C or C++ interlaces. 

ActiveX, OLE, and COM 

ActiveX and OLE for Macintosh are both built on the 
powerful foundation of the Component Object Model The 2.0x 
version of OLE was a monolithic release which incorporated COM 
and the OLE libraries in a single shared library (for PowerMac) or 
68k Extension, The latest version of OLE has been broken out into 
constituent libraries which contain related functionality, one of 
which is the Microsoft Component Library which supports Mac 
ActiveX controls. This factored version of COM/OLE interacts 
more efficiently with Apple’s Code Fragment Manager, 
performance is improved and less code is mapped into memory 
on launching an OLE application. 

The latest version of COM, included in the Mac ActiveX 
SDK, has been optimised for lightweight, high-performance, 
in process objects such as ActiveX controls. New API’s make it 
easier for applications or controls to exploit the Alias Manager 
and work within the Mac-specific runtime world to deliver 
compelling Macintosh solutions, ActiveX controls require the 
use of the new Microsoft Component Library ami arc not 
compatible with OLE 2.0x. 

SDK Contents Overview 

The ActiveX SDK for Macintosh consists of three separate, 
downloadable archives available at: 

< http ://www. m icrosoft. com/i ntde v/sdk/m ac/maai vex . htm I > 

ActiveX SDK (SDK_sea,hqx, -25 MB) — SDK, including 
sample controls and containers, projects, source, headers, COM 
libraries, and ActiveX plug-in adapter. 

ActiveX Runtime (Runtime_sea.hqx, ~600Gk) — binary files 
needed to run ActiveX controls in commercial containers such as 
Internet Explorer and Netscape Navigator. (Note: this archive 
contains the 4 MS IE ActiveX Lib (PPC )' library required to use 
ActiveX controls in verskms of Internet Explorer later than 30hh 
ff you are using 3 Oh I or earlier, the ActiveX SDK archive listed 
abate contains all the runtime binaries required and you can 
skip this downloads 

ActiveX Documents (Documents_sea.hqx, -600k) — 
documentation describing how to create and run ActiveX controls 
on Macintosh, it contains the ActiveX User & Technical Guides, as 
well as documents covering more advanced ActiveX topics such as 
asynchronous monikers and code download* This archive also 
includes an introduction to COM and a Gnnponcnt Object Model 
technical overview/specificaLion. 

Note that the Beta3 release of the Mac ActiveX SDK is 
currently being finalized and will he available by the time this 
article is printed. Reta3 will be fully compatible with Metrowerks 
Code Warrior 11. There will be a document in the SDK correcting 
any informal ion presented here which needs revision in order to 
build and run the Reta3 samples. The Beta2 release is fully 
compatible with Metrowerks Code Warrior 10. 


The ActiveX k>k Macintosh SDK 


General Overview 

The ActiveX SDK for Macintosh includes: 

1. Microsoft Component Library & ActiveX Plugin. 

2. Sample Controls. 

3. Sample Conta i ne rs. 

4. Source, headers, GUIDs, and other supporting files. 

5. Utilities. 

The Microsoft Component Library includes the most 
important elements of the Component Object Model, managing 
object instantiation, the Registry and essential COM .simctures, 
Tliis library can be used to build other, custom interfaces* The 
ActiveX interfaces are built on this library and do not require the 
OLE 2.0x libraries. The ActiveX Plug-in permits the use of ActiveX 
controls in browsers that support Netscape Navigator-compatible 
plug-in technology. 

The Microsoft Component Library was named comi2.ppc.ret 
in previous beta releases of the Mac ActiveX SDK, You should 
throw away any copies of this file which exist on your system 
before using the latest version of the SDK. 

The SDK Sample Controls include samples demonstrating 
basic features of Mac ActiveX controls including property retrieval, 
data streaming, event handling, drawing, popup menus, dialogs, 
outgoing custom interfaces, and more. These samples have been 
designed to easily serve as the basis for writing your own controls, 
Metrowerks Code Warrior version 10 or later is required for 
building all Macintosh ActiveX controls* 

The Mac ActiveX SDK ships with seven! Sample Containers 
which provide a simple environment fur testing individual controls, 
including a Metrowerks PowcrPlant-based container that extends 
PowerPlam document and view classes to host controls. 

SDK Utilities include tools for managing the COM 
Registration Database, registering and unregistering controls, 
GtJID creation, bin-hexing, and more* 


More SDK Details 

Folders in the SDK include 


■Quicksort’ 

COM Libraries 
Common 

Container Common 

(kintainers 

Omt ml Common 

External libraries 

Gnkis 

Headers 

Sample Controls 

UrtMon 

Utilities 


Documents and tools for getting started in ActiveX right away 
Debug and retail versions of Mac COM 
files used to build ActiveX controls and containers 
Files used to build more than one simple container 
Sample ActiveX containers (induding Netscape plug-in) 

Files used to huild more than one sample control 
Shared libraries used by ActiveX controls 
COM globally unique identifier (GUID) definitions 
ActiveX system header files 

Source code and HTML for samples {sec preceding section) 
Support for COM URL Moniker interface 
ActiveX utilities 


SDK Utilities 

The Utilities folder contains these utility programs: 

AutoBin Automatical!) generates binhexed versions of controls 
Create GUI]) Generates Cil IfDs tor interfaces and controls 
DcScoder Decodes COM error values 
Rcglidil Edits the COM Registry ('PPC Registration Database ) 
Register Adds/rtmovcs a control from (he registration database 
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When a control is created for the first time, it must be 
binhexed so that the automatic code download feature wQl 
download it, decode it (un-binhex it), and register it in the COM 
Registry. AuloBin is a drag-drop utility which is used to create 
binhexed versions of controls. 

New controls need a globally unique identifier (QUID) 
defined in their local register.h. Use the CreateGUID utility to 
generate a unique ID and copy it into the register.h file. Also, 
don't forget to copy this string into the HTML file that runs 
your control 

GUIDs (globally unique identifiers), are 128-bit values used 
to identify COM/ActiveX interfaces and object classes (something 
like an application Creator code identifies an application, only in 
16 bytes, not 4X HDs are interface identifiers, a type of GUID 
which specifically identify interfaces, IIDs are used typically when 
requesting an instance of an interface implementation. CLSfDs, or 
class identifiers, identify object classes. CLSiDs associate objects 
with particular ActiveX controls. 

DeScoder is a simple utility which returns human-readable 
strings from error values returned by COM/ActiveX API and 
methods. Typing in a value of 0x80030002, for example, returns 
the more descriptive error label i STG_E_FILENOTFOUND 1 . 

If you have to edit the COM registry (named TPC Registration 
Database' inside System:Preferences) directly, use the RegEdit 
utility. This program displays the contents of the current COM 
registry and allows you to edit, add, and remove keys. Removing 
keys of outdated controls is the most common use of this utiliiy. 
However, the Register utility program can do that for you as well. 

The Register utility provides a simple means of adding or 
removing control registry information from the Registration 
Database, In actual use, a control will be registered as part of its 
code download and installation process. 'Hie Register utility is 
more useful for removing outdated control information before 
testing a new version of it. To use Register, shift-drag the shared 
library of the control you want to unregister onto the Register 
application, The COM libraries must to be either in a common 
system location, such as the Extensions folder, or in the same 
folder as the control t>eing unregistered 

Getting Started 

Follow these steps to familiarize yourself with the contents of 
the Mac ActiveX SDK: 

1. Install the rtmlime fifes required for your browser., 

2, build the ActiveX SDK samples. 

3* Run the sample controls. 

4. Study the sample control source code (and the ActiveX 
Technical Guide), 

6, Modify a sample control in order to create your own. 

(y. Build and run your own control. 

The resL of this article provides more detail on accomplishing 
each of these steps. 


Install the Runtime Files 

Mac ActiveX controls can lie viewed in several different 
containers and browsers. Commercial containers include 
Microsoft Internet Explorer 2.1 or later, Netscape Navigator 2.0 or 
later. To run controls in Internet Explorer 3.0b 1 or earlier, 
Navigator, or Cyberdog, install the ActiveX Plugin and die 
Microsoft Component library. The ActiveX Plugin should be 
placed in die browser Plug-ins folder; the Microsoft Component 
Library lives in the SystemiExtensions folder. An OpenDoc part 
adapter is currently in development to support ActiveX controls in 
Cyberdog and should be available soon. 

Before using Microsoft Internet Explorer to run Mat: ActiveX 
controls, make sure and do the following: 

1. Run Internet Explorer to create the ‘Explorer' folder inside 
System:Preferences. 

2. If you are using Internet Explorer 3-0 (later than hi), drag MS 
IE ActiveX lab (PPG) from the ActiveX Runtime portion of die 
SDK to System:Extensions. 

3. Eor Internet Explorer 3,0b l or earlier, or if using another 
browser that supports plug-ins, such as CyberDog or Netscape 
Navigator, drag die ActiveX Plugin to your Plug-ins folder. 

4. Drag the Microsoft Component Library from the ActiveX SDK 
portion of the SDK to System:Extensions. Die Build ActiveX 
SDK’ script located at the root of the 'ActiveX SDK 1 folder will 
perform steps 2-4. 

5. Choose Edit/Preferences within Internet Explorer, then dick 
the ‘Web Content 1 tab. Make sure ‘Use Plug-In Objects' is 
checked* In Internet Explorer version 2.1 r choose 
Edit/Options, click the 'Web Content" tab, and make sure 'Load 
Plug-In Objects' is checked. 

6. Restart the computer. 

Build the ActiveX SDK Samples 

Individual ActiveX sample controls can be built by opening 
the sample projects with McLrowcrks Code Warrior version 10 or 
later and compiling. Die SDK includes a script labeled ‘Build 
ActiveX SDK' which will configure your system for running 
ActiveX controls (by copying required shared libraries to the 
Extensions folder, etc.) and build all samples in the SDK. If diere 
is a problem building any samples during script execution, you 
can cancel by die king the process icon in the upper right corner 
of the Mac monitor, selecting liuiltl ActiveX SDK' in order to bring 
the seripL to the foreground, and pressing command-period. 

Run the sample controls 

After configuring your system and building a sample 
control, running it is simply a matter of dragging the HTML 
(xxx.htm) file found in the sample control folder onLo your 
particular Web Browser. 
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Writing Your Own Control 

Notes on the SDK Sample Code 

CBaseControl.cpp and .h in the Control Common folder 
contain the source for the ActiveX control base class from which 
all other controls descend. Each individual control folder contains 
the files CxxxControl.epp and .h, which include the source for the 
subclass. Controls thaL do data streaming will pull in the 
CBaseBindStatusCallback class, found in Control Common, in 
order to receive progress status and data streams. 

The ActiveX base classes are provided as a convenience to 
the developer, providing baseline functionality which speeds 
control development. Developers are encouraged to use the base 
classes but are not limited to them — any semantically equivalent 
implementation of the interfaces can be used. The Mac ActiveX 
development team is interested in feedback on the base classes in 
order to make them better and better See the end of this article for 
information on contacting the development team through a 
Microsoft-provided mailing list. 

Kegister.h in each control’s project folder contains the defines 
for the sample control GUTDs, program IDs, and so on r required 
for COM registration. 

The sample controls override anywhere from 2 to 15 methods 
of the base control depending on the features desired. For simple 
controls dial have no data or properties, you only have to modify 
some of die event methods and Draw' methods. For properties and 
data, one or both of the Load methods and possibly the 
OnStopBinding and OnDataAvailable methods of 
CBaseBindStatusCallback must be modified. The Clock is the 
simplest, with no data or properties. 

The Piet Player, MoviePlayer and LislRox all implement data 
streaming to some degree. PictPlayer is an example of a control 
that receives data through multiple data streams. Instead of mixing 
in and subclassing CBaseBindStatusCallback, a separate subclass 
CPictControlBSC is instantiated for each data stream. The 
LVIoviePlayer demonstrates data streaming to a file. 

Modify, Build and Run a Sample Control 

You can prepare for writing your own control by copying an 
existing control folder and modifying it. The most basic sample 
conLroI is the dock, as it supports only event handling and 
drawing, with no support for properties or data streaming. 

Here are the steps; 

1. Rename files as desired* 

2. Modify the event and Draw methods for basic functionality, 

3. Modify the Load, OnStopBinding and/or On Da La Available 
methods as necessary for I he level of streaming support you 
require. 

4. Define an identifier in the prefix file for your control. 

5. Add new GUID and constants for your control within the 
register.h file. 

6. Build, 

7. Generate a Jiqx file from Lite shared library file of your 
new control. 


8. Modify the HTML file CODEBASE and DATA arguments to point 
to your .hqx file for code and any data file you may have. 

9. Modify the HTML file CLASSID argument to die ASCII value of 
your new CLSID GUID. 

10. Drop your new HTML file onto Internet Explorer. 

What could be simpler? If your control runs successfully, you 
probably did everything right. If not, check to make sure your URLs 
for CODEBASE and DATA are correct, as well as the ASCII 
CLASSID. Make sure an entry for your control appears in the 
Registry'. Check die ActiveX Cache in System:Preferences:Explorer 
to see if your control is there. 

SpyClock 

This section is a step-by-step example of modifying an SDK 
sample in order to create a new, custom control The sample well 
modify is ‘Clock 1 , the simplest control in the Mac ActiveX SDK, 
with no persistent data or properties. Wei! Instrument this control 
in order to write debug information tracking calls to various 
control information out to LRPCSpy, an OLE for Macintosh 
debugging utility. LRPCSpy is located in the Beta3 SDK Utilities 
folder. Also, be sure to check out CodeSampler in the SDK 
‘QuickStaif folder. This tool takes care of much of the work 
involved in generating a new control based on one of the samples. 
The detailed information given below is a good way to become 
familiar with ActiveX controls and the work done by CodeSampler 
to create new versions of them. 

Clock Modifications 

1. Duplicate die ‘Clock 1 sample folder and rename it ’SpyClockl 

2. Within the SpyClock folder, delete the following files, if they 
exist: Clock, Clock.hqx, and Clock ,x$ym. 

3. Rename all file names from ‘Clock* to ‘SpyClock*, (clock.acx 
should be named spydock.acx, for example, 
CClockControLcpp should be CSpyOockControLcpp). 

4. Drag a copy of CBaseCOM.cpp from the SDK ‘Common' folder 
to die ‘SpyClock’ folder. Drag a copy of CBaseControLcpp 
from the 'Control Common' folder to SpyClock' We will 
modify both these files later on and don’t want the changes to 
be pulled into other controls. 

5. Open the SpyClock. jj project file in Metrowrks Code Warrior 

6. Choose ‘Add File.*.’ from die Project Menu. Add SpyClock.rsrc 
and CSpyClockControl.cpp to the project, 

7. Remove references to Clock, rsrc and CClockControLcpp from 
the project. 

8. Open CSpyOockControLcpp and do a Find/Replace All, 

replacing all references to ClockComrol with 

SpyClockControl. 

9. Repeat step #7 in file CSpyClockCoiitroLh, Save and dose 
the file, 

10 Add the following line to die beginning of 

CSpyClockContiol.cpp: #indude “spy.h” (This header will be 
created in a later step). Save and dose the file, 

IT Choose 'Project Settings... 1 from the Code Warrior Edit Menu. 
Select TPC Project’ in the Project section. Edit the project 
output file name to SpyClock, 
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12. Still within Project Settings, select 'C/C++ Language’ in the 
language Settings section. Edit the Prefix file name to read 
SpyClockPrefix.h. Close the Project Settings dialog. 

13- Open register.!!. Do a Find/Replace All, replacing all 
references to Clock with SpyClock, 

14. Switch to the Finder, locale the CreateGuid.ppc utility in the 
SDK, and launch it. CreateGuid.ppc will automatically generate 
a new GUID for use in our modified control on startup, 

15. Click Lhe 'DEFINE_GUID X radio button. This changes the 
representation of die GUID currently displayed to an ActiveX 
macro statement which will literally construct the 128-bit 
GUID value in the project on compiling. Click 'Copy’ to put 
diis macro statement on the Clipboard. 

16. Back in the CodeWarrior IDE, select the first three lines of 
register.h and then Paste. 'This will replace Clock's 
DEHNE_GIJID macro with the new version provided by 
CreateGuid.ppc. Replace the «name» placeholder in the 
macro statement with the label l CLSlD_ocx' (no apostrophes). 

17. Select the text representation of our new GUID from the 
commented line at the top of register.h, Select the GUID from 
the left brace all the way through the right brace, then 
Edit/Copy or press cmd-C 

18. Select the remaining instance of Clock's GUID in register.h 
from brace to brace. Press cmd-V or Edil/Paste to replace it 
with the new GUID. Save and close register.h, 

19< Open spyclock.acx (still within CodeWarrior), select the old 
GUID in its entirety, and Paste the new version. Save and 
close the file. 

20. Open SpyClock,inf, select the old GUID at the end of the file 
from brace to brace and replace it with the new version. Do a 
Find/Replace All, replacing all occurrences of Clock with 
SpyClock. Save and close the file. 

21. Open SpyGlock.htm* Replace all occurrences of Clock’s GUID 
in this file with the newly generated GUID. Both GUID 
instances in this file appear without braces. Be sure to delete 
the right and left braces from the new GUID after pasting each. 
Save and close die file. 

New Code for SpyClock 

Now it's time to generate some new code (at last]). Choose 
New from CodeWarrior's File menu and save the file as “spyJi” 
to the SpyClock folder. Type the following into the spy.h, save, 
and close: 

fifndef _SFY_H_ 

#define JPYJL 

^include <sTrijig.h> 

^define 5Z_MM_LEN 128 

void SpyQutputDebugStting (const char *3?.) : 

Boolean SimpleSendHi ghLevelEveni ( GSTjfpe sig. 

OSTypt* eventClass* 

GSType eventID* 
unsigned long msgRefCon* 
char 4 eventBuf* 
unsigned long bufLen); 

fend if //‘SPY H 


Create another file inside CodeWarrior and save Lhis one 
to disk as “spy.c”. Type the following into the “spy.c" window, 
save, and close: 

^include *spy.fcT 

void SpyOutputDebugString{eonat char *sz) 
i 

long cb: 

char buf [SZ_MAX_UH] ; 

cb = strlen(sz); 
if (cb > SZ_HAX_LEN) 
cb - SZ_MAX_LEN: 

BloekMove(sz,buf.cb); 

S imp! eSendHighLevel Event (‘LSpy f f *Dbg2 ’ f ‘TEXT* .O.buf,cb); 


Boolean SimplefsendHighLevelEvent (OSType sig. 

OSType eventClass. 

OSType eventlD, 
unsigned long messagcFcCCon* 
char *evenlBu.r, 
unsigned long bufLen) 

( 

EventRecord theHLEvt; 

OSErr err; 

theHLEvt .what = JtH.1 ghLevelEvent; 

theHLEvt on essage ~ eventClass; 

theHLEvt.where = * (Point *) &eveotID; 

err = FostHighLevelEventUtheHLEvt. 

sig. 

messageRefCnn, 

(Ptr) eventRuf. 
bufLen, 

receiverlDisSignature); 

If (-917 = err) 

err = PostHighLevelEventUtheHLEvt* 

sig, 

mesSageRcfCon, 

(Ptr) eventBuf, 
bufLen* 

receiverlDlSSignature): 

if (noErr “ err) 

return true; 

else 

return false; 

1 

Add spy.c to the SpyClock project anti we're ready to use 
the SpyOutputDehugString routine to write output messages to 
Lhe LRPCSpy utility . SpyOutpuLDebugSlring checks the length of 
the debug string passed to it, does a BiockMove to a local 
buffer, then passes the latter to Simple Send High Level E vent. 
SpyOut put DebugString specifies LRPCSpy’s creator code TRPC 
as the target for the high-level event, LRPCSpy supports an 
event class signified by the id ‘Dbg2\ ‘TEXT' indicates the type 
of message we’re passing. 

SimpleSendllighLevelEvent does exactly what its name 
implies: it creates and sends a simple high-level event, If the first 
try returns a value of -917 (‘session was closed 1 ), it makes a 
second attempt. Note that SimpleSeodHighLevelEvent returns a 
Boolean to indicate whether or not the event was sent 
successfully. The implementation of SpyOm put DebugString 
above does not test for a return value. 
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Also worth noting is that SpyOutputDebugSuing could easily 
be replaced with other functionality. The buffer passed in could 
be converted to a Pascal string and passed to DebugStrO for 
example, it could open a text file and write the information to 
disk, it could also be modified to pass the buffer to another 
ActiveX control (such as the Console control) for output. The SDK 
Popup sample actually contains an example of the latter. 

Now that SpyOutputDebugString is in place„ it's time to 
instrument the Spy Clock sample so that we can track code 
execution when the control is running. Open CBaseConlrolcpp 
and add a ^include of “spy.h” to the beginning of the file. Then 
add SpyOutputDebugSLring statements to the beginning of each 
method implementation in the file. Inside CBaseOx>ntn >1:: SeLSite, 
for example, add the following statement at the beginning of the 
member function: 

Spy Our put DobugS t tin g 

{ "GBiis&Ccuittol :; iObjectWithSite: : Set Site \r"); 


Note that die message passed to our output routine contains 
a complete reference to the method called, that is, it reflects the 
specific: interface TObjeetSite which is wrapped by CBaseControl. 
These ‘complete* function names appear in the comments 
prefacing each CBaseControl method. Just Copy and Paste to add 
them to each call to SpyOutputDebugString, 

After modifying the SpyClock copy of CBaseControl.epp, 
open CBaseCOM.cpp and make similar changes to each method 
implementation in the file. Don't forget to add a ^include of 
“spy.h" before any calls to SpyOutputDebugString. 

Now it’s time to build our new control! 

Build, Bin Hew and Run! 

1 Build SpyClock within Metrowerks CodeWatrior. 

2. Drag the resultant control labeled ‘SpyClock’ onto i he 
AutoBin 1.0 utility. This will generate a binhexed 
representation of the control inside the SpyClock folder 
named 'SpyClock.hqx'. 

ir Launch LRPCSpy, Be sure to modify LRPCSpy’s Preferred 
memory partition size to at least 5I2K before running. 

4, Drag Spy Clock, htiri onto Microsoft Internet Explorer or other 
supported Web Browser. 

After doing so, you should see the SpyClock control appear. 
A window will appear in LKPCSpy in the background. You 
should see text messages appear in that window which track 
various control object methods as they are called. 


That’s ajul Theke is to it! 

Tliis detailed control modification example should tell you 
all you need to know in order to start creating your own ActiveX 
controls on Lhe Macintosh today. The SDK is filled with 
interesting, powerful examples to study and serve as a basis for 
the next generation of content-rich Web development. ActiveX is 
built on a native Macintosh implementation of COM, which has 
been broken out of OLE and optimized to support high- 
performance, lightweight, in-process control objects. Why not get 
started on your own today, and see what conies next, tomorrow? 
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■A IkOS version is coming so t m. 

• It will work unmodified under MacOS 8. 

* it is very reliable, aixi patches no raps. 

* Client and server vendors, llie jxotnenl speafiealiun, lutr^ial docu¬ 
ments, and the source axle to a client called WritisweH Jr* are at: 

http://www.wordservices.org/ 

• Spdldieek WSI NewxWatchtr-gcl (he si >mu:ax}e free! 

• Spellcheck your HyperCard fields - get die XCMD free! 

• Get help with Wind Services questions Iran: 

Crawford Software Consulting 

130 Indian Hollow, Unit B 

Aptos, CA 95003 

crawford@scruznet.com (408) 685-9019 




For those of you with wind left in your lungs and a desire to 
dive even deeper into what makes ActiveX tick on the Macintosh 
platform, read on. 



Figure L ActiveX,for Macintosh Architectural Overview . 

The overall ActiveX for Macintosh architecture can be 
viewed as follows: 

An Interface is an array of function pointers known as a 
virtual table. The functions pointed to by the members of a viable 
are called the methods , or member functions, of the interface. In 
C++ terms, an interface is an abstract base class, composed of 
pure virtual functions, which specifies a protocol without 
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providing an implementation. Although C++ Is extremely 
convenient for defining interfaces — because C++ builds the 
vtable for you — interfaces can be defined, implemented and 
used in any language. 

An AetiveX/COM interface defines a contract between any 
object which implements the Interface and any client which 
makes use of it, This contract includes the name of the interface 
and its methods, the parameter types, and the purpose of each 
member function, An object must implement all methods in an 
interface and adhere to the defined protocol (or intent) of each 
routine. By convention, interface names follow an EXXXXX format 
— IControl and lunknown, for example. 

As shown in the figure above, applications implement an 
[Container interface to host ActiveX controls. The [Container 
interface can be implemented for each container of controls 
within the application, or potentially for the application itself. 
Typically, an implementation of this interface would be 
instantiated for each document of an application that hosts 
controls. This interface would also be implemented by controls 
that will host other controls. 

A control site is an object in the application that is instantiated 
for each control. The control site implements interfaces needed by 
the application and the control hosted by the site. The control site 
object generally exposes a Control Site API to the client 
application to enable creation and destruction of the control site* 
The control site may optionally expose an IControl interface on 
the site object, used by the client application once the control has 
been created. Alternatively, the control site may simply return the 
IControl interface of the hosted control to allow more direct 
communication. 

IUnknown is Lhe base COM interface from which all other 
ActiveX interfaces are derived. It defines methods for three member 
functions: Querylnteiface, AddRef, and Release. Query!ntetface 
provides the basic COM mechanism for interface negotiation 
(retrieval of pointers to specific interfaces). AddRef and Release 
comprise COM reference counting, a mechanism for controlling 
object lifetime which allows independent objects to obtain and 
release pointers to the same object without coordination, 

Hie IUnknown interface is the only required interlace for all 
COM objects* IUnknown is fully documented in numerous other 
sources, including two documents in the Mac ActiveX SDK, COM 
Introduction and COM Technical Overview, 

A control site object exposes at least an IUnknown interface 
and IContainerSite interface to the hosted control. Other interfaces 
are acquired by querying the IUnknown interface of the site or 
through the IServiceProvider interface. A typical control site object 
design appears as follows. 



Calls from contrc 


Figure 2 


Sites connect to controls by passing a pointer to their 
IUnknown interface to the control* Controls will typically 
immediately query the site for the IContainerSite interface, which 
will Income the primary callback interface. 

Communication to the control can occur through any number 
of interfaces, the most basic Ixring the IContml interface* Tire 
IControl interface allows the control to receive calls such as events, 
focus notifications, activation notifications, and drawing. If a control 
has no persistent data or properties, this is all that must lie 
implemented* Other optional interfaces shown in die Control object 
reference the IPersist*** (for example, IPersistStream or 
IPersis+PropertyRag) and IBindStattisCallback interfaces that must be 
exposed for persistent properties and data streaming operations, 
respectively. A typical control object design is shown here. 


| C6.11s from Sfte or other Clien 




ILJnkfwr 

10bject WithSite JContro 




IPeraW" 

IBindStatusCaJIbac 




Figure j* 


Writing ActiveX Controls 

The mechanics of building ActiveX controls are documented 
later in this article as well as the SDK ActiveX User's Guide * WiLh 
this information, it is possible to use base classes provided in the 
SDK to build controls by overriding a few methods. This section 
documents in more detail the interfaces that can be implemented 
by control writers. 

An ActiveX control musL implement some or all of the 
following interfaces: 

IUnknown COM query and reference counting 

IObjeetWithSite Access to Control Site through generic siting 
IControl Basic Control Methods 

IPersist*** Persistent properties and date 

IBindStatusCallback Data. Streaming Notification 


A control that has no persistent properties and has no 
need to retrieve data from a URL can choose to implement only 
the IUnknown, lObjectWithSite, and IControl interfaces. 
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Controls that have persistent properties must implement one or 
more IPersist interfaces. Controls that must stream data to and 
from the Internet must implement the Data Streaming 
notification interface, IBindStatusCallback. For many of these 
interfaces, the Macintosh ActiveX SDK provides default 
implementations so that many controls only need to override a 
few methods to get baseline functionality. 

Macintosh ActiveX controls must implement the 
lObjectWithSite interface to get access to the control she. Since the 
control site either implements or delegates important functionality 
front the outside world, this interface is very important. 
lObjectWithSite is documented in detail in the document, Internet 
Controls. The interface is defined as follows: 

interface lObjectWithSite 
l 

AXErrorCode SetSite ( [ini IUnknown* Site ); 

AXErrorCode GetSite ( [in] REFTTD ItefTD, [oui] IUnknown'’ 

Site ): 

I; 

fObjectWithSite::SetStte simply gives the control an IUnknown 
interface to use for obtaining other interfaces on the site as shown 
above in the control site diagram, lObjectWithSite::GetSite returns 
the site that is currently set on the control. As shown in the above 
interface, Macintosh ActiveX controls return an AXErrorCode 
which is synonymous with the 11 RESULT type defined earlier for 
QLE2. 

With these two interfaces it is theoretically possible to write 
a minimally functional ActiveX control Of course, the control 
would have no UI and could not handle events. But it could use 
the site to get properties and stream data. In order to write a truly 
useful control that has UI and participates more completely in 
the life of the container, the IControl interface must be 
implemented. This important interface is covered in detail in the 
ActiveX Technical Guide, 

Controls that support [>ersistent properties and/or data must 
implement one or more persistence interfaces. These include 
IPersistMoniker, IPersisrStream, IPersistStorage, IPersistMemory 
and IPersistPropertyBag. Of these, TPersistPropertyRag is the 
recommended interface for retrieving properties that are specified 
either on the command line or in a URL for a run-time control. 
IPersistStream will become more important as HTML authoring 
environments that support ActiveX controls become available, 

ActiveX sites will call the controls IPersistPropertyBag::LoadO 
method with an IPropertyBag Interface so that the control can 
retrieve persistent properties. When Lhe control receives this 
call it can use the IPropertyBag interface given to read the 
persistent properties. 

Full documentation of Lhe [Persist*** interfaces is available 
from many other sources and is beyond the scope of cite SDK 
documentation. ActiveX for Macintosh uses these interfaces as 
specified in other sources. References include: 

Understanding ActiveX and OLE by David Chaj?fwii. 

ActiveX Controls Inside Out by Adam Defining. 

Inside OLE Second Edition by Kraig Brockschmidt. 

Internet Controls (from the ActiveX SDK). 


In order to get data across the Internet that is not retrieved as 
a simple property from a property’ bag interface, controls mast 
support data streaming interfaces as documented in the URL 
Moniker and Asynchronous Moniker The control must implement 
only the IBindStatusCallback interface for notifications such as 
progress, data available, and stop binding. In particular, the 
control must implement the IBindStatusCaElback::OnDataAvaifable() 
method for notification whenever new data is available from the 
net. 

The URL Moniker interfaces support both a push and puli 
model of data streaming as well as file streaming. More 
information on how ActiveX for Macintosh uses these interfaces 
can lie located in the following SDK documents. 

URL Monikers. 

Asynchronous Moniker Specification. 

Microsoft Technical SirppoRT 

Paid Support for the ActiveX for Macintosh SDK 

The Macintosh ActiveX SDK is supported by Microsoft 
Technical Support. You can ask questions through your Premier 
Level support contract. You can also ask questions through your 
Priority Level contract or purchase individual Priority Support 
incidents (essentially a one-time fee for a single issue or problem). 
If you would like more information on Microsoft’s paid support 
options, call Microsoft Support Sales a! (BOO) 936-3500 from 6:00 
a,m, to 6:00 p.m. Pacific time, Monday through Friday, excluding 
holidays, Microsoft Technical Support is also available on the 
World Wide Web at <http;//www.microsoft.com/sypporT/>, 

Free support for the ActiveX for Macintosh SDK 

Newsgroups are a great place for free peer support. As time 
and resources allow, Microsoft developers, program managers, 
support engineers, and test engineers visit the site to collect 
feedback and answer specific questions or correct 
misinterpretations. Microsoft's participation largely depends on 
bandwidth and time, which is greatly affected by shipping 
schedules. Some interesting news groups for Internet Explorer are 
on inicrosoft. internetex pi t irer. 

To access newsgroups, use your preferred newsgroup reader 
and enter the news server address as <news;//msnews.miaosoft.com>. 
You can use Lhe following URL to access die newsgroup directly 
from a Web browser: <news.miaosoft.pubtic.newsgroup-name>. The 
newsreader included with Internet Explorer version 3/) supports 
multiple news servers; you can download the newsreader front 
<http;//www.microsoft.ram/ie/ie3/imn.htm>. 

lhe Internet Explorer for Macintosh team maintains a site of 
known issues affecting the current release at: 
<http://www,microsoft.com/iesupport/content/issues/>. 

Developers working with the ActiveX for Macintosh SDK can 
subscribe to a mailing list to receive support and ask questions. To 
subscribe, send e-mail to <mactivex-dev@ws63,psdbay,xo.com>, using 
a subject line of “subscribe". For detailed information on other 
mailing lists covering Microsoft Internet technologies, visit the 
Mailing Lists page on this Web site. VB 
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PROGRAMMER'S 

CHALLENGE 


by Bob Boonstra, WestforcL MA 



Turing Machine 

A Turing Machine is a finite state machine augmented with an 
infinite amount of external storage, formatted as a sequence of 
squares on a linear tape. 'flic behavior of the Turing Machine is 
described by a set of rules, each of which contains a current state, 
an input symbol, a next state, an ouLpui symbol, and a move 
direction. At any given lime, the Turing Machine is described by 
tire current internal slate, the position of its read write head on the 
tape, and the contents of the tape. Each dock cycle the Turing 
Machine reads the square of die input tape on which the read-write 
head is positioned, replaces the contents of that square by writing 
an output symbol based on the input and the currenL state, and 
moves left or right one square on the tape (or halts), 

Because they have access to an unbounded amount of 
storage, Turing Machines can solve problems that finite sLate 
machines cannot. An example of such a problem is parenthesis 
checking. Given an input of left and right parentheses, delimited 
by the special symbol "A', such as: 

OOOGAt ()[(£))({ {Aoooc 


Your Challenge this month is to implement a Turing Machine. 
The prototype for the code you should write is: 

typedef unsigned long uiong: 

lyped^f emila [ kMoveLeft-O T kHalt“0 f kMoveRigbt=l I MoveDir; 

typedef struct TMRulc I /* rule in proRjam RirTM V 

uiong a IdState; /* (his rule fte when oiirtnLSme — ddStalc and 7 

uiong input Symbol; t oirrmrSymbol = LnputSymbol 7 

uiong newState: r act cuntntState 10 orwStatr when ihss rule fiirs 7 

uiong out put Symbol; t write outpuiSymbul id tape when this rule fires 7 

MoveDir moveDirection: f move left or rigjit as indicated wtira ihis rule fines 7 

I TMRulc; 

typedef void (*TMMoveProc) { 
uiong outputSyinbol. 
uiong newState, 

MoveDir raoveDirection 

1; 


Boolean /* success7 TuringMachine( 

const TMRulo iheRulcsu , f pointer to progr-im lorTM 7 
uiong ouiuRuIge, 


); 


uiong *theTape, 
uiong tapeLen* 
long rwHeadPoe. 
TWMoveProc ReportMove 


f number of rules inTM program 7 
T pcnnrcf ir> input tape (hrTM 7 
t theTftptlll|,ihcTapqtapelei-IJ Is valid 7 
/*TM read head is si iheTapctnvttalFbsl 7 
f allluck proc lu inform caller of e ach move 7 


...the following set of rules will determine whether the 
parentheses are will-formed, meaning that they can lie paired off 
so that each left parenthesis has a balancing right parenthesis: 


State 

Input 

NewState 

Output 

Move 

0 

) 

1 

X 

Left 

0 

( 

0 

{ 

Right 

0 

A 

2 

A 

Left 

0 

X 

0 

X 

Right 

1 

) 

1 

) 

Left 

1 

( 

0 

X 

Right 

1 

A 

1 

0 

Halt 

1 

X 

1 

X 

Left 

2 

( 

2 

0 

Halt 

2 

A 

2 

? 

Hait 

2 

X 

2 

X 

Left 


This machine scans right in state 0 looking for a right 
parenthesis. When it finds one, it moves to state one, replaces the 
right parenthesis with an T, and moves to state 1 to scan for a left 
parenthesis., which it also replaces with an X. If i! encounters the 
'A 1 delimiter when kx>king for a balancing parenthesis, it halts 
after writing a ‘0\ indicating that the parentheses are not wdl- 
fomied. if all parentheses are paired off, it writes a T indicating 
the input is well formed. 


On input, your Turing Machine will he provided with 
numRules rules governing the behavior of the Turing Machine, 
The rules are pointed to by theRules, You will also be provided 
with a input tape pointed to by theTape, with a finite number of 
contiguous squares preinitialtzed to the Turing Machine input. 
The read-write head will be positioned on the input tape at 
theTape[rwHeadPosf Ail other squares of the input tape will be 
empty, indicated by a binary zero. Your TuringMachine should 
begin in state 0, read the first input symbol, and find the 
appropriate rule. It should invoke the callback ReportMove to 
inform my test code of w hat your machine is doing, providing 
the outputSymbol that you will write to the tape, the newState of 
your finite stare machine, and Lhe move Direct ion for the new 
position of Lhe read-write head. You should then update 
theTape, move your read-write head, and update Lhe Turing 
Machine state. 

When your TuringMachine encounters a rule with a 
moveDirection of kHalt. you should make a final callback to 
ReportMove and then return TRUE. If your TuringMachine 
exceeds the tapelen of theTape, or if you are unable to find a 
mlc lhat applies to your current machine state and the input 
symbol, you should return FALSE. It is my in rent to provide all 
necessary input rules and a sufficient length of tape, but your 
machine should fail gracefully if an input bug or an 
implementation bug results in running out of tape or 
encountering a bad input symbol . 
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Your code will be timed with a sequence of rule/tape pairs, 
and rhe solution that completes execution of the inputs correctly 
in ihe shortest total time will be the winner. Half of Lhe tests will 
use a “universal’" Turing Machine, where the rules describe a 
general Turing Machine interpreter, and the input tape contains 
another Turing Machine program. The time executed by the 
ReportMove callback will be included in your solution time. The 
callback will look something like the following. 

static: void ReportMove (long out put Symbol * long newState, 
MoveDit moveDirection) 

f 

if C {gTape.Pos>*0) && CgTape?ns<gTapeLen)) 

gTapofgTapcP&s] - ouLpuLSymbol; 
gTapePos -*= niuveDitcction; 
gState = nevState; 

1 

You may noL modify the input rules pointed to by theRules, 
but you may allocate reasonable additional storage if you would 
like to preprocess the rules in some way, provided you deallocate 
the storage before returning. 

For those of you that would like additional information on 
Turing Machines, you can refer to almost any textlxjok on 
automata theory or the theory of computation. My personal 
favorite is Compulation, Finite and Infinite Machines, by Marvin 
Minsky, © 1976 by Prentice-I lull. 

This will be a native PowerPC Challenge, using the latest 
Code Warrior environment Solutions may be coded in C, C++, 
or Pascal. 

Three Months Ago Winner 

Congratulations to Gregory Cooper lor narrowly defeating 
the second place entry by Jeff Mallett in the March Hex 
Challenge. Hex is played on an NxN rhombus of hexagons, with 
players alternately occupying hexagons, one playing vertically 
and the other horizontally, each trying to complete an unbroken 
chain before the other does. The Challenge awarded 10 points for 
each victory in a round robin tournament, with the score reduced 
based on the execution time of die winning solution. 

The third-place solution by Eric Hangstefer used a purely 
offensive strategy, building bridges in an attempt to force the 
opponent to play defense. The other two solutions applied both 
offensive and defensive techniques, and between them won all of 
the games in the tournament. Gregory's solution plays defense 
whenever ii believes that its opponent is closer to a solution than 
he is. To accomplish this, he maintains a Path data structure for 
himself and for Ills opponent identifying what he believes to be the 
best (shortest) path across the board for each player. A path score 
is maintained by counting the number of hexagons along the path 
that still need to be occupied to complete an unbroken chain 
(excluding “two-bridge” positions w r here a connection is 
guaranteed). One key to understanding the winning solution is the 
ExtendPathToEdge routine, used by the BestPathAcrossBoard 
routine to find a short route to each edge from a central hexagon. 

The tournament consisted of three lest cases, with hex boards 
of size 8, 10, and 18, with each solution competing against each 
other twice, once playing first and once playing second. Gregory’s 


solution and Jeffs solution competed against one another six times, 
and, interestingly enough, in all but one of those contests, the 
solution playing second (i.e., horizontal) won the game. In most of 
the games, Gregory’s and JefFs solutions required comparable 
execution time, except in two instances where Gregory s solution 
t<x)k very long to make its final move. This behavior accounted for 
the fact that the two solutions were veiy dose in cumulative points, 
even though Gregory won two more games. By virtue of having the 
highest point total, the most victories, and (as a tie-breaker) the 
smallest code, Gregory’s solution is the winner. 

The final position in the 10x10 game where Gregory' played 
the vertical orientation and won is reproduced below for your 
enjoyment. Note the vertical player's focus on a single path by 
comparison with the more scattered hexagons occupied by the 
horizontal player. 

0123456789 

0--VHH-H 

1 --VV-H--HV 

2- -HV--H-V- 

3- VHHH — 

4- -V--V-V-- 

5 - V H H- 

6-VVHH-V- 

7 - - V V H - - V - - 

8 - - H V - H- 

9 - - V H- 

The table below lists for each entry the number of 
tournament wins, the total tournament points earned, and the 
code and data sizes. The number in parentheses after the entrant’s 
name is the total number of Challenge points earned in all 
Challenges to date prior to this one. 


Name 

Wins 

Points 

Code 

Data 

Gregory Cooper (3D 

10 

80.08 

8028 

628 

Jeff Malta (64) 

8 

1%% 

HfiOS 

392 

Eric llangsiefer (2) 

0 

0.00 

S236 

38 


Top 20 Contestants 

I lere are the Top Contestants for the Programmer’s Challenge. 
The numbers below include points awarded over the 24 most 
recent contests, including points earned by this month’s entrants. 

Hank Name Points Rank Name Points 


1. 

Munter, Ernst 

184 

11. Cutis, Kevin 

21 

2. 

Gregg, Xan 

114 

12. Nicoile, Ludovk 

21 

3. 

Larsson, Gustav 

67 

13* Picao, Miguel Cruz 

21 

4. 

Cooper, Greg 

54 

14. Brown, Jorg 

20 

5. 

Lengyd, Eric 

40 

15. Gundrum, Eric 

20 

6. 

Boring, Randy 

37 

16, Higgins, Charles 

20 

7. 

Mallett, Jeff' 

37 

17. Kasparian, Raffi 

20 

8. 

Lewis, Peter 

32 

18. Slezak, Ken 

20 

9. 

Antoniewiez, Andy 24 

19. Studer, Thomas 

20 

10. Beith, Gary 

24 

20. Karsh, Bill 

19 
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There are three ways to earn points: (1) scoring in the Lop 5 
of any Challenge, (2) being the first person to find a bug in a 
published winning solution or, (3) being tine first person to suggest 
a Challenge that I use. The points you can win are: 

1 st place.., 20 points 5th place .* . 2 points 

2 nd pi ace.10 points finding bug .2 points 

3rd place...7 points suggesting Challenge...2 points 

4th place .4 points 

Here is Gregory's winning solution: 

Hex_Stratcgy.c ® 1997 Gregory Cooper 


upTwoBridge. 
upLeft, 

u pLeftTwoBridge* 

left. 

downLef tTwoBridge * 
downLeft. 
downTwoBridge. 
downRight, 
do-wnRi ghtTwoBrid ge. 
noBiruction 
) Direction; 

// a data structure for representing potential routes to edges or to other chips 
typedef struct Path 
t 

long row; 
long col; 

Direction nextDirection; 

Direction prevDirection; 

Boolean occupied; 

Boolean center; 

struct Fath’next; 
struct Path*prev: 

} Path; 

// a data type for the playing chips 

typedef enuun { 
empty, 

blue, // plays first 
red // plays second 
} Chip: 

//an enumeration for disposing of unneeded paths 
// (used by the BetterPaih function and its clients) 

typedef enum [ 

leaveBad. // indicates that inferior strategy should be left alone 

f o r ge t Bad // indicates that Inferior strategy should be disposed 
) PathAction: 

// m enumeration for the edges 
typedef enum I 
leffEdge, 
rightEdge, 
topEdge. 
bottomEdge 
1 Edge; 

// an enumeration for path disruptions 

typedef enum J 

n qD i s r u p t i on. // move did not block path 

in Two Bridge * // move occupied part of a two-bridge 

i n S p o t // move occupied a strategic location 

I Disruption; 


// row of piece on board 
// column of piece on board 
// direction to next piece 
// direction to prev piece 
// location actually taken? 

// origin of pa ib? 

// next piece in path 
// previous piece in path 


// 90 
//l 2D 
// 150 
//180 
// 210 
//M) 

// 270 
// 300 
// 330 

// undefined 


Function Prototypes 

Path *BestPathAr.rossBnard (long boardSize, Chip •theBbard, 
long startRow, long startCol, Chip color); 

// tries to find a path across the board through (siartRow, started) 

// PRECONDITIONS: boandSric is the number of rows or columns 
// on the board; theBoard stores information about the board; 

// (stan Row, start Col) indicates a piece of the given color on the board; color indicates 
// which player for whom the path is to be found 
// POSTCONDITIONS; returns a pointer to the path found, beginning with 
// (startRow, startCol), or returns nil if no path exists 


// General idea: My strategy tries to find the quickest routes across the board, both for 
II itself and for its opponent If the opponent has a better shorter route than my 
// strategy does, then my strategy makes a defensive move (one that makes it more 
// difficult for the opponent to complete liis route). Otherwise, it makes an offensive 
II move (one which brings Its own route closer to completion), It retraces the routes 
// during each turn, looking for necessary modifications and scoring changes. 


Boolean ExtendPathToEdge (long boardSisje, Chip * theBoard, 

Path *path, Edge edge); 

// tries to find a path from path to the given edge 

// PRECONDITIONS: path is an incomplete path, edge is one of the four edges, 

If boardSize is the number of rows or columns on the board, theBoard defines the 
II playing board 

II POSTCONDITIONS; if a path from the edge exists, it is found and the value true is 
II returned; otherwise, all memory associated with the path is freed and it returns false 


^include 11 Storage, h" 

II an enumeration for move types 

typedef enum 


II counter-clockwise from right 


right* 

//o 

npRightTwoBridge, 

//30 

up Right, 

//(SO 


void PrioritizeMoves[Edge edge. Direction moveList[12]); 

II determines the order in which potential moves in a path should be attempted 
// PRECONDITIONS; edge is the edge to which we arc try ing to move 
II POSTCONDITIONS: movdist contains the moves in order from most to 
// least direct 

Boolean PosaibleMove(long boardSize, Chip ‘theBoard, 
long row, long col* Path ‘path* Direction move* 

Chip color); 

If determines w hether placing a piece in a given location is feasible 
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// PRECONDITIONS: boarcJSizc is the number of rows or columns on the board; 

// thetfoard defines the booed; (row, col) is fire piece from which we arc moving; 

// move is Lhe direction in which we are moving; color is the color of the player 
if POSTCONDITIONS: returns true if the given move is possible, false otherwise 

void FindNewI<oc0tionClong row. long col T Direction move, 
long ‘newRow, long *ncwCol); 

// determines the location of a piece adjacent to another piece in a given direction 
H PRECONDITIONS: (row, col) indicates the initial piece, move Ls the direction of 
ff the move 

ff POSTCONDITIONS: CnewRow, hiewCol) contain the location of the new piece 

Direction QppositeMrection (Direction move)j 

ff determines the direction opposite a given direction 
ff PRECONDITIONS; move is a direction 
ff POSTCONDITIONS: returns the direction opposite move 

Boolean GnBoardUong boardSize* long row* long col); 

ff determines whether a given piece lies on die board 
ff PRECONDITIONS: boardSizc is the size of the board, 
ff (row, col) is the location of the desired piece 
ff POSTCONDITIONS: returns whether the piece is 
ff within the boundaries of the hoard 

Boolean IsTwoBridge(Direction move); 

ff determines whether a connection in a given direction is a two-bridge 
ff PRECONDITIONS: move is the direction of the desired connection 
ff POSTCONDITIONS returns true if the connection is a two-bridge; 
ff otherwise returns false 

Boolean TvoBrtdgeFree(long boardSize. Chip 'theBoard, 
long row, long col. Direction move): 

ff determines whether a given two-bridge is free 

ff PRECONDITIONS; (row, col) contains one of the pieces in in the two-bridge, 
ff move is the direction of the bridge, boardSize and UicDoatd define die board 
ff POSTCONDITIONS: returns true if the spaces in between are free; 
ff otherwise, returns false 

Boolean PieceOnEdgeOong row* long col* long boardSize* 

Edge edge); 

// determines whether a given piece is on a desired edge 

ff PRECONDITIONS: (row, col) indicate a piece, boardSize is the number ol rows or 

ff columns on the board, edge is the desired edge 

ff POSTCONDITIONS: returns true if the piece is on the edge: 

ff otherwise returns false 

void FtecPathfPath ‘path); 

ff disposes the memory associated with a path 

ff PRECONDITIONS: path points to a path 

ff POST CONDITIONS: the memory associated with the palh is freed. 



hffp://www.webcs.com 


E-mail: pricmgraiwebcs.com 24 Hour InfuFAX: I-508-854-1789 


WEBsite Hosting Services 


OPTIONS 


Six accounts to choose front 
packed with features like 
OGf, secure server, audio 
support, FTP and TELNET 
logon access with plenty of 
storage space: all at stable 
and competitive rates* 


Full internet merchant 
solutions and on-line 
payment systems make doing 
business on the wch easier 
than ever before! 


You’ve 
Found 
Your Web 
Home 


Full on-line docs, fast 
response customer support 
and avails hie webpage design 
make your adjustment to our 
servers a breeze. 

Your success on the web is 
our success* Personal and 
business sites stored the easy 
way: with NO HASSLES, 


Direction GetJDirec Lion (long cowl, long coll, long row2, 
long co!2); 

// determines the direction from one piece to another 

ff PRECONDITIONS: (rowI, coll) and (row2, eol2) define two pieces 

ff POSTCONDITIONS; the direction from (rowl F coll) to (row2 T cul2) is returned 


Boolean ValidMoveflong boardSize. Chip ‘theBoard. 
long row. long col): 

// determines whether a desired move is legal 

// PRECONDinONS: boardSize contains the number of rows or columns on the 
ff board; thcBoard defines the playing board; (row, col) is the location of the intended 
ff move 

ff POSTCONDITIONS: returns true if the piece is on the board and not already taken; 
ff otherw ise false 

Disruption MovelnPath(Fath ‘path, long row. long col); 

ff determines whether a desired move is in a path 
ff PRECONDITIONS: path describes a path across the board; 
ff (row, col) defines the intended move 

// POSTCONDITIONS: returns noDisruption if the move is not in the path. 
ff inTwobridge if it threatens an established two-bridge, or inSpol if it occupies a 
ff location in the path (including a twudjridge whose end-points have not been 
ff secured) 

Boolean TwoRridgeThreatened(long row, long col. 
long threatRow, long threatCol* Direction move): 

ff determines whether a two-bridge is threatened by a given move 
// PRECONDITIONS: (row, col) is the origin of a two-bridge; (threaiRow, threat Col) 
ff is the new move; move is the direction of the two bridge 
ff POSTCONDIT IONS: returns true if the two-bridge is threatened by the move 

void UpdatePath(Path ‘path* long row. long col); 

ff updates a path when a move is made 
// PRECONDITIONS: path points to a path across the board; 
ff (row. col) is the location of the move 

ff POSTCONDIT IONS: the location in the path is marked as being occupied; 
ff sometimes, as when a two-bridge is filled in (and destroyed), an extra nude is added 
ff to the path list 


Path ‘BorterPath(Path *pathi* Path *path 2. 

PathAction action); 

ff determines which of two paths is superior to tire other 
ff PRECONDITIONS: path I and path2 point to paths 
ff POSTCONDITIONS: the better of the two paths is returned; 
ff if action is forgeUkd, then the inferior path is disposed 

long PathRating(Path ‘path): 

// rates a path 

// PRECONDITIONS: path is a path 
ff POSTCONDITIONS: a rating for the path is returned 
ff (always positive, low numbers are better) 

void FillThreatenedTwoBridge(Fath ‘path, long threatRow, 
long threatCol, long ‘row* long ‘col): 

ff determines where to move in order to secure a threatened two-bridge 
ff PRECONDITIONS: path points to a path; 

// (threatRow b threat Col) is the move which threatened the two-bridge 
ff POSTCONDITIONS (row, col) is the move needed to secure 
ff the free half of the two-bridge 

Path ‘TakeDetourdong boardSize, Chip ‘theBoard* Path ‘path* 
long row. long col, Chip color); 

ff finds a new path after it has been disrupted 
if PRECONDITIONS: path points to a path; (row, col) 

// indicates a move which disrupted the path 

// POSTCONDITIONS: the path Is corrected, if possible, so that it avoids the 
ff opponent's piece, and it is then relumed: nil is relumed if no new palh can be found 

void FindBestMove£Path ‘ourPath, Path ‘oppPath* long *rov P 
long *co!): 

//TRIES to determine the best move 
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// PRECONDITIONS: ourPath and oppPath art 1 (fie expected 
// paths of the player and the opponent, respectively 
// POSTCONDHIONS: (Tow, *coi) indicate the chosen move, which should he 
// decent; if the opponent's path is hctter f it should he a defensive move; if not, it 
// should be an offensive move; whenever possible, offensive and defensive moves are 
// made to coincide with one another 

Boolean NextToEdge(long row. long col, long boardSize, 

Edge edge); 

// determines if a piece is next to a given edge 

// PRECONDITIONS: (row, col) is a piece; boardSizc is the size of the board, 

// edge is the edge we want to be near 

// POSTCONDITIONS: returns true if the piece if one hex from the edge 

Boolean Hex(long boardSize, long oppRov, long oppCoI. 
long 'moveRow, long 'moveCol, void *privStorage, 

Boolean nevGame, Boolean playFirst): 


Hex 

Boolean Hex.(long boardSize* long oppRow* long oppCol, 
long “moveRow, long ‘moveCol, void *privStorage, 

Boolean newGame, Boolean playFirst) 

I 

// hoard storage (preserved between turns) 
static Chip*theBoardi; 

// expected paths (also preserved between turns) 
static Path *ourPa.th, 'oppEath; 

// a temporary path used for comparisons 
Path ‘nevPath; 

Disruption disruption; //holds path disruptions 
if (newGame) 

l 

long It 

// initialize the private storage allocation system 
InitiallzeHeap (privStorage* 0x100000); // 1 MU 
// initialize storage space fur the board 

theBoard - AllocateBlorkfboardfHze * boardSize); 
for (1=0; i < boardsIze * boardSizc: i++) 
theBoard[i] - empty; 

// indicate that no paths have vet been determined 
ourPath = oppPath - nil; 
it (playFirst) 

I 

// go in the middle 

‘mnveRow ” (boafdSlze I) / 2: 

‘■oveCpl “ boardSize / 2: 

// mark the chip on the (ward 

TheBoardL*moveRow 1 boardSize + 'moveColJ = 
blue ; // blue because we are moving first 
// try to determine the shortest route across the board through the spot where 
// we just moved 

our Path = RestFathAr rossRoa rd (boardSizc, 
theBoard* *noveRow, 'moveCol* blue); 
return true; 

I //end if 
\ II aid if 

// check the opponent's move 

if (IValidMove(boardSize, theBoard, oppRov* oppCol)) 

// if it is illegal, abort here 

return false; 

// mark the opponent's move on the hoard 
theBoard[oppRow * boardSize + oppCol] “ 
playFirst 7 red : blue: 

// if the opponent's move was in his path (offensive) 
if (Mo velnPath (oppPath, oppRow, oppCol)) 

// update his path 

DpdatePathfoppFath. oppRow, oppCol): 
else // opponent did not continue his expected path 

I 

// try to find a probable route for the opponent ilirougli the piece where he just 
// moved 

nawPath " BestPathAcrossBoard(boardSize, theBoard* 
oppRow, oppCol. playFirst 7 red ; blue): 

II if his new route is better than his old one, use it instead 

oppPath = BetterFath(oppPath. newPatb, forgetBad): 

} II end else 

II determine whether Ills move blocked or otherwise disrupted our path 
disruption * MoveInPath(ourFath* oppRow, oppCol); 

If (disruption — inTvoBridge) 

I 

II move into the other half of the 


// two-bridge automatically 

FillThreatenedTvoBridge(ourFath, oppRow , oppCol* 
moveRow, moveCol); 

// mark the move on the board 

theBoard['moveRow * boardSize + *moveCol] - 
playFirst ? blue : red; 

II update the path 

UpdatePath(ourFath, "moveRow, “moveCol); 

) //end if 

else // no au tomatic response 
I 

if (disruption — inSpot) 

II try to find a new path from just 
II before the disruption (the unaffected 
II part of the path can remain) 

ourFath = TakeDetour(boardSizc, theBoard, 
ourFath, oppRow. oppCol, playFirst ? blue ; 
red} ; 

II try to determine the best move and then make it 
FindBestMove(ourPath* oppPath, moveRow, moveCol); 
II if Ole move was invalid (happens when neither 
II player has a path), just try to find a valid move 

if £ lValidMovejboardSize, theBoard, *movcRow* 
‘moveCol)) 

I 

Boolean moveFound - false; 
for (*moveRow - 0; I moveFound && *moveRow 
< boardSize: (*moveRow)++) 
i 

for (‘moveCol = 0; 'moveFound && # BioveCoI 
( boardSize; (*moveCol)++) 

[ 

if (ValidMove(boardSize. theBoard, 

‘moveRow. ‘moveCol)) 
l 

moveFound = true: 

(‘moveRou)—; 

(‘movcCal) t 
[ //endif 
I //endfor 

I II end for 
] //end if 

II mark the move on the board 

theBoard[‘moveRow 4 boardSize + TaevnCol] = 
playFirst ? blue ; red: 

II cheek to see if the move was in our path 
if (MovelnFathtourFaih, ‘caoveRow* ‘moveCol)) 

II if so, update it 

Updatepatb(OurPath* ‘moveRov* ‘moveCol); 
else 
I 

II otherwise, try to find a path through the 
II new location 

newFath = BeetPathAerossBoard(boardSize. 
theBoard. *moveRo¥, ‘moveCol. 
playFirst ? blue ; red); 

II if the new path is better titan the old one, use it instead 

ourPath = BetterPath(ourFath. newPath* 
forgetBad); 

] // end else 
\ //endif 

1/ if our move blocked the opponent's path, 

If try to find him a new path from just before the disruption 

if (MovelnPath (oppFath h *HiDveRow, *moveCo1)) 

oppPath = TakeDetour(boardSize f theBoard f oppPath, 
'moveRow. *moveCol r playFirst 7 red, ; blue]: 
return true: 

\ If end Hex 


BestPathAcmssBoflid 

Path "BestPatbAcroEsBoard(long boardSize, Chip ‘theBoard, 
long atartRow. long startCol. Chip color) 

( 

// initial path is gist the starting hex 

Path *theFath = AllocateBlock(sizeof (Path)); 

thePath->row = startRow: 
tbePath->eol * atartCol; 
tbePath->occupied = // should he true always 

theBoard [startRow ‘ boardSize + utartCol] ^ color; 

If no connections yet 

rhePath->prev “ theFath->next = nil; 
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thePath->pE:evDirection = thePath->ne:stI}irection “ 
noDirection; 
thePat!i->center - true; 

// find the best path from (startRow, started) to the 
H top (if blue) or left (if red) edge 

if (I Extend PathTo Edge (board Size. theloard, thePatb, 
color =“ blue ? topEdge : leftEdgc)) 
l 

FreePath(tbePath): 
return nil: 

1 //end it 

// find the best path from (startRow, started) to the 
// other friendly edge 

if (I ExtendPatblViEdge (boardSl 2 ®, theBoard, thePath, 
color = blue ? bottotnEdge : righr/Edge)) 

f 

FreePath (thePath) ; 
return nil; 

j U end If 

ff if we made it here, we succeeded 
return thei’aLh; 

// end BcstPatliAcrossBoard 


FxtendPathToFdge 

Boolean ExtendPathToEdge(long boardSize. Chip UheSoard, 

Path 4 path. Edge edge) 

I 

Di tec L i on novel, [ at. [ 1 ?.] : if stores the move priorilia 
// which color we are 

Chip color = edge “ IcTlEdge || edge “ rightEd&e ? 
red : blue; 

long tnoveNum; ff an index fur when we try to move 
ff which way the path is going 

Boolean goingForward = edge -* rightEdge | 
edge — hottornEdge; 

Boolean result: // did we succeed yet 

ff prioritize the moves according to which edge we 
ff arc seeking and tile current location in the path 
PrioritizeMaves(edge , moveLliit); 
ff sEi>p U we are already at an edge 

If fPiereOn£dge{path'>row h path>Col. boardSize, edge}) 
return true; 

ff see if we are next to the edge 

if (HexlToEdge{path >row, pat.h->col* boardSize, edge)) 

{ 

Direction d; 

long newRow, newCol; 

ff make the simplest move to reach the edge 
for (d = right: d < redirection: d++) 

If ( ITsTwoBtidge(d)) 

I 

l'in4MewLooaLion (path )row, path->col, d, 
knevRow, knewCol); 

if (FieceOnEdge(newRow h newCol, boardSize, 
edge) && VaiidHove(boardSizc. thcBonrd. 
nevRow, newCol}} 

i 

ff allocate space tor the new node 
Path *newKodo ■ 

AllocatoBloek(sizeof (Path)); 
newNode >row - ticwRow; 
newNodeOcol = newCol; 
ff determine if it has been secured or not 
newHode-Occupied - theBoard[ 
newNode->rov * boardSize + 
newNode->coil = color; 

// it is not the center (it is an extension) 
newNodc >center * false; 
if link the new node to the old path 
if (goingForward) 

[ 

path->nextDirection = d; 
psth~>next - newNode; 
newNode->pravDirection = 

OppositeDiroction(d): 
ncwHode->prev = path; 
newWode >next ■ nil; 
ncwNodc >nextDirection = 
noDirection; 

] if end if 
else 


Guess which 
installer 
was built by 
Draglnstall. 


Installer : 


PJ Shoiw Recommended Uaiallitlora 


ESS E ?“ ;E ^ 


-a 

t^^WHVflNlTOh 


mm 


Ci 


Startup 

VMispi« 

3 


The left fide of frt wtodoV stWvS To start , 

select one or nvyy of trwse toons and drag to any dfsK on siy- right side 
of tt» vlndftv 


[ Hem! Mr ] 

[ Quit 1 



Guess again. 

If you guessed that the first installer was 
built by Draglnstall, you’re only half right. 
Now with Draglnstall 3.0, you can build both 
of these installers from a single script file! 

For more Information about Draglnstall 
and a free demo, visit our web site at 

http://www.sauers.com/draginstall 

or give us a call at 1 - 800 - 890 - 9880 . 
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path JprevDirectiou 3 d; 
path^>prev - nevNode; 
nevNode->r*extBi rection - 
OppcsiteDirection(d); 
nevNode->next - path; 
newNode->prev “ nil; 
nevNode-)ptevDirection - 
noDirection: 

I // end else 
return true; 

1 //end if 
] // end for 
] //endif 

// first look u> connect with a piece that is already on the board 
for (result - false, moveNum * 0; 

I result && moveNum ( 9: moveNutn+’t) 

i 

// once a single move works, try to extend from 
// the new location to the same edge 

if (PossibleHove(boardsize, theBoard. path >row, 
path->col, path, moveList[moveNum]. color)) 

f 

// allocate space lor the new* node 

Path *nevNode “ AlIocateBlock{sizeof (Path)); 

// abort if there is not enough memory 
if (!nevNode) 
return false; 

// define its position 

FindNewLoca t Lon(path’> row. pa th >col, 
moveList[moveNum], &nowNode >rov, 
&nevNode->col); 

// determine if it has been seemed or not 
nevNode‘ Occupied » theBoard[nevNode->row * 
boardSize + nevNode->col] M color; 

// only make the move if then: is already' a connection 
if {{nevNode - Occupied) 

FreeBlock(newNode); 

continue; 

) 

// it is not the center (it is an extension) 
nevNode- >center - falsa; 

// link the new node to the old path 

if (goingForward) 

f 

path >nextDirection = moveListImoveNuml; 
path >next = nevNode; 
nevNode->prevDirection ** 

OppositeDirectionCmoveListfmovoNmnl); 
nevNode->prev - path; 
nevNode’>next “ nil; 
nevNode-hiextM rection noDirection; 

) //end if 

else 

t 

path >prevDlrection = movelist[moveNural: 
path >prev = nevNode; 
newNode->nextDireetion “ 

GppositeDirectionfmoveList [moveNum]); 
nevNode->nert - path; 
nevNode->prev - nil; 
nowNode-yprevDlrection * noDirection; 

] // end else 

// see if we can get to an edge 
if (ExtendFathToEdge(boardSize, theBoard. 
nevNode* edge)) 

result - true; 

I //end if 
else 
{ 

// undo the added node 

FreeBlock (nevNode); 
if (goingForvard) 
f 

path->next ■ nil; 

path->nextDirection = noDirection: 

I //end »f 


else 

I 

path->prev « nil; 

path->prevDirection * noDirection; 

j // end else 
] //end else 
1 // end if 
| //endfor 

// try moves until wc run out or one works 

for (moveNum = 0; I result is moveNum < 7; moveNuirH-) 

// once a single move works, try' to extend from 
// die new' location to the same edge 

if fPossibleMoveiboardSize, thefloard, path->rov t 
path >col* path. novelist[moveNum], color)) 

// allocate space for Uic new node 

Path *newNode “ AllocateBlockUizeof (Path)); 

// abort if there is out enough memory 
if (InewNode) 
return false; 

// define its position 

FindNewIiDCation (path->row. patb->col. 
moveList [maveNum] . &nevNode->row, 
5mevNode->col); 

// determine if it has been secured or not 

nevNode-Occupied “ theBoard[nevNode >row * 
boardSize + nevNode->col] == color; 

// it is not the cemer (it is an extension) 
nevNode ^center = false; 

// link the new node to the old path 
if (goingForvard) 
f 

path->nextDirection - moveList[moveNum]; 
path-)next ** nevNode; 
nevNode->prevDireclion ” 

OppositeJDirection (moveList LmoveNumJ); 
nevNode->prev - path: 
nevNode->next “ nil: 
nevNode->nextDirection “ noDirection; 

1 // end if 
else 
( 

path ->prevDirection 12 moveList [moveNum]: 
path >prev = nevNode: 
n ewMod e - >n exxB i re c t i on * 

GppositeDirection(moveList {moveNum]); 
nevNode->next *» path; 
nevNode->prev " nil; 
nevNode >prevDirection " noDirection; 

1 // end else 

// see if we are at the edge or can get to one 

If ( ExtendPathToEdge{boardSize. theBoard, 
newNode, edge}) 

I 

result * true; 

I // end if 
else 
\ 

// undo ihe added node 
FreeBlock(nevNode); 
if (goingForvard) 

{ 

path->next * nil; 

path->nextDirection “ nnDlroot ion; 

] //end if 

else 

f 

path >prev = nil; 

path->prevDirection = noDirection: 

I // end dsc 
I //end else 
I // end if 
I //endfor 

// return true if we succeeded, false if not 
return result: 

I //end HxiendRuhToEdgc 
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void PrioritizeMoves(Edge edge. Direction move[12]) 

( 

switch (edge) I 
case ieftEdge: 

// in order from mosi to IcaM direct 
move 10] * downLeftTwoBridge; 
move ft] - upLeftTwoBridge: 
move [2] “ downTwoBridge; 
move[3] “ left; 
move [4j “ downLeft; 
move [5j * upleft; 
moveL&] * downRight; 
move[7] “ upRight; 
move[B'J - right; 
move [9] * upTwoBridge; 
move [10] - downRightTwoBridge; 
move [llj _ upRightTwoBridge: 
break: 

case rightEdge: 

// in order from most to leas! direct 


Priori tkcMoves 


move [D] 
move[1] 
move [2) 
move [3] 
move[4] 
move [b] 
move[6] 
move [7] 
moveI8j 
move[9] 
movef10] 
move [ II] 
break; 
case topEdgc: 

// in order from most to least dimer 


upRightTwoBridge: 

d ovnRigh tTwo Bridge; 

UpTwoBridge; 

right; 

upRight: 

down Right; 

upLeft; 

downLeft; 

left; 

downTwoBridge; 

[ upLeftTVoBridge; 

! downLeftTwoBridge; 


move[0] 
movel1] 
move[2] 
move[3] 
move[4] 
move[5] 
move[6] 
move 17] 
moveiB] 
move[9] 
novel10] 
move fill 
break; 
case bottomEdge; 

// in order from most to least direct 


upTwoBridge; 
upLeftTwoBridge; 
upRightTwoBridge; 
upleft; 
upRight; 
left.; 
right; 
downLeft; 
downRigbt: 
downLeftTwoBridge; 

! downRightTwoBridge; 
downTwoBridge; 


move[0j = downTwoBridge; 
move[lJ = downRightTwoBridge* 
move [2, * downLeftTwoBridge: 
move[3 - downRight: 

move[4] “ downLeft; 
movef5] * right; 
tioveffi] ” left; 
move[7] - upRight; 
move[8] ** upLcft: 
move[9] = UpRightTwoBridge; 
move[10j = upLeftTwoflridge; 
move[II] “ upTwoBridge; 
break; 
default s 

break; // shi mid never arrive here 
] // end switch 
1 // end PriorititcMoves 


PrissihleMove 

Boolean FossibleHovetlong boardSize* Chip 'theBoard* 
long row, long col. Path 'path. Direction move. 

Chip color) 

I 

1 ong newRow* newCol: // where the mtive leads 

// determine where a move in the new direction would lead 
FindNewLocation(row* col* move, &ncwRow» &ncwCo1); 

// the new location must be on the board and either 
jj empty or occupied by a friendly piece; Li must also 
// not be in the path already 


iff!OnBoa rd(boa rdS ize. newRow * newCol) 

| (theBoard[newRow 1 boardSizo + newCol] " 
leolor = bine ? red ; blue)) || 

MoveInP ath(pat h, n evRow, newCol)) 
return false; 

// if the move forms a two-bridge, there must 
// be no pieces in betw een the two 

if {IsTwoBridge(move)) 

( 

return TwaBridgeFrectboardSize. theBoard. row, col* 
move); 

J //endif 

else 

return true; 

] //end PossihleMow 


FindNew Location 

void FindNewLocation[long row. long col. Direction move, 
long 'newRow, long 'newCol) 

\ 

If handle the row first 

switch (move) i 
case upTwoBridge: 

'newRow * row - 2; 
break: 

case upRightTwoBridge; 
case upRight: 
case upLeft; 
case upLeftTwoBridge: 

*newRov = row - 1; 
break; 
case left: 
case right; 

'newRow = row: 
break; 

case downLeftTwoBridge: 
case downLeft: 
case downRight: 
case downRightTwoBridge: 

4 newRow “ row + 1j 
break; 

case downTwoBridge; 

'newRow “ row + 2; 
break; 

default: // should never gel here 

break: 

J // end switch 

// then handle the column 

switch (move) I 

case downLeftTwoBridge; 

'newCol = col 2; 
break: 

case upLeftTwoBridge: 
case left: 
case downLeft: 
case downTwoBridge: 

‘newCol ~ col - l: 
break; 

case upleft: 
case downRight; 

'newCol = col; 
break; 

case upTwoBridge: 
case upRight: 
case right: 

case downRightTwoBridge: 

'newCol = col + 1; 
b reak; 

case u pRightTwoBridge; 

‘newCol * col + 2: 
break; 

default: // should never get here 
break: 

) //endswitch 
J // end RndNcwLocation 


OpposfteDirccdon 

Direction OppositeDirection(Direction move) 

I 

switch (move) l 
case upTwoBridge: 

return downTwoBridge: 
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case upRIgh t TvoB ri d gr>; 

return downhoftTwoHridge: 
case uplUght: 

return downLeft; 
case upieft; 

return downRight: 
case upLeftTwoBridge: 

retutn downRightTwoBridge; 
case left: 

return right; 
case right: 

return left; 
case dovnLeftTwoBridge: 

return upRightTvoBridge; 
case downLeft: 

return upRight; 
case downRight; 

return upLeft-i 
case downRighlTwoBridge: 

return upLeftTwoBridge; 
case dowtiTwoEridge: 

return upTvoBridge; 
default: // should never pci here 
break: 

I // end switch 
I // end OpposittDirection 


Onikmd 

Boolean Onboard(long boardSlze, long row, long col) 

return row >- 0 && row < boardSize hh col >“ 0 hh 
col < boardSlze; 

I if end OnRoanl 


IsTwo Bridge 

Boolean IsTwoBridge(Direction move) 

t 

switch (move) ( 
case upTwoBridge: 
case upRightTwoBridge: 
case upheflTwofiridge: 
case dowriLcfiTwoBridge; 
case downRightTwoBridge: 
case downTwoBridge; 

return true: 
default: 

return false; 

//end switch 
\ if end IsTwoBridge 


TwoBridgcFrec 

Boolean TvoEridgeFree(long boardSlze, Chip 'theBoard* 
long row, long col. Direction move) 
i 

switch (move) [ 
case upTwoBridge: 

return IheBoard[(row I) 1 boardSlze + col] == 
empty &flt LhcBoard[(row 1) • boardSize + 
col + i] = empty; 
case upKighiTwaBridge: 

return theBoardL(row 1) * boardSlze * 
col + 1] “ empty && theBoardfrow * 
boardSlze + col + l) = empty; 
case upLeftTwoBridge; 

return theBoarri[(row - 1) * boardSixe + 
col] ““ cmpLy thcBoard[row 1 
boardsizo +■ col 1] “ empty; 
case downLeft'IVollridge: 

return theBoardj.(row + 1) * boardSlze + 
col * 1] ** empty && theBoardfrow * 
boardSlze + col - 1] = empty; 
case downRightTwoBridge; 

return theBoard[(row + 1) ■ boardSlze + 
col] ™ empty h(t iheBoard[row * 
boardSlze + col + 1] = empty: 
case downTwoBridge: 

return theBoard[(row +1) * boardSlze + 
cel] empty && theBoard [ [row + 1) * 
boardSlze + col - 1] “ empty; 
default; 

return false; 

I // end switch 

1 //TwoRridgcFicc 


PteccOnFdge 

Boolean PieceOnEdgeflong row, long col, long boardSlze* 

Edge edge} 

i 

switch (edge) t 
case leftBdge: 

return col = 0; 
case rightEdge: 

return col “ boardSise * 1: 
case topEdge; 

return row = 0; 
case bottomFdge: 

return row = boardSlze - 1; 
default: // should never get here 
break; 

I // end switch 

I // end FtectOnEdgc 


FnccFiath 

void FreePathfPath 'path) 

I 

if (!path) 
return; 

// go to the beginning of the path 

for (: path->prev; path « path->prev); 

// free each node until none arc left 

for (; path; path = path>next) 

FreeBlock(path); 

// end FreePath 


YalidMove 

Boolean ValidMoveUong boardSize, Chip 'theBoard, 
long row, long col) 

{ 

return OnBoard(boardSIzo* row* col) bfr 

theBoiird [row * boardSlze + col] empty;//free 
I // end Valid Move 


MovdnPath 

Disruption MoveInPath(Fath 'path* long row* long col) 

[ 

if (Ipath) 

return noDIsruptlon; 

ff go lo ihe beginning of the path 

for (; path>prev; path ** path*>prev): 

// starch lilt path until the end js readied or a node 
// Is found matching the desired move 

for (: path; path * path >next) 

// check for a threatened two-bridge 

if (TsTwoRridge(paih >nojst Direct! on) (k& 

TwoBrid geThr ea t ened(path->row * path->col, 
row. col* path->nextDirection)} 

i 

if (path ^occupied && path->next->oceupied) 
return inTwoBridge; 
else 

return inSpot; 

} if end if 

else if (row **= path >row col == path-)col) 
return inSpot; 

// d wc gel here* there are no disruptions 
return noDieruption; 

I // end Muvt lnPuth 

TwoBridgeTitreatened 

Boolean TwaBridgeThrentened(long row. long col, 
long threatRow* long IhreuiCol* Direction move) 

I 

switch (move) I 
case upTwoBridge; 

return (threatRow =■ row - 1) Lh 

(threatCol = col || threatCol “ eol + i); 
case upRightTvoBrfdge; 

return (threatCol — col + 1) 

(threatRow ***■ row 1 || threatRow = row); 
case upLeftTwoflridge; 

return (threatRow + threatCoi ^ row + col - 1) 

&& (threatRow =« row || threatCol — col); 
case downLeftTvoBridge; 

return (threatCol " col - 1) hb. 

(threatRow == row || threatRow “ row + .1); 
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case downRightTwoBridge; 

return (threatRov + threatCol = row + col + 1) 
&& (threatRov row J| threatCol = col); 
case dovnTvoBridge; 

return (throatRow ” row + 1) && 

(threatCol — col 11 threatCol — col ■ 1); 
default: // should not get hen: 
return false: 

I //endswitch 
] //endTwoDiidg*1hR*atcned 


UpdatcPath 

void UpdatePathCPath 'path, long row, long col) 

i 

// go to the beghming of the path 

for (; path->prev: path = path >prcv); 

// search die path until the end is reached or a node 
// is found matching the desired move 
for (; path; path * path->next) 
if check for completion of a twofuidge 
if (IetwoBridgetpach >nextDlrection) && 

TvoBridgeThroatoned Epath >rov, path->col. 
row. col. path >nextDireelJon)) 

I 

if destroy the twbridge and create two new connections 

Path 'nevNode - AllocateBlockEsizeof (Path)): 

ncwNode->row " row; 
newKode >co1 - col; 
newNode >occupicd ” true: 
newfiode>cemer “ false; 
newNode->prevDirectioti - GctOirection( 
row. col* paih->row* path>eolj; 
newNodeOnextDireetion “ GetDirectionf 

row. col, path->next->row. path->nexT->coi): 
newNode >prev * path; 
newNodc >next ■ pathOnext: 
path >nextDlrectier “ OpponlteDirectionf 
newWade->prevDirection): 
path>next - newNode; 
newNode->next■>prevDirettion = 

CppoalteDirection(newNode>nextDxrection); 
newfJode >next->prev * nevNode: 

I // end if 

else if (row *=* path >row hb col = path->col) 
path*>occupied " true; 

I // end UpdatcPath 

Get Direction 

Direction GetDiraction(long rowl* long coll, long row2 * 
long col 2) 
t 

// check for unique cases first 
if (row2 — rowl + 2) 
return downTwoBridge: 
else if (row2 * M - rowl - 2) 
return upTvoBridge: 
else if (co!2 — coll + 2) 
return up RightTwoB ridge: 
else If (col? — coll - 2) 
return dawnLefLTwoBrIdge; 

// then try ihc more common ones 
else if (row? = row! - 1) 
if (col2 = coll - 1) 
return upLeftTwoBridge; 
else if (col2 “ coll) 
return upLeft; 
cl go // co!2 ts col I 
return upRlght; 
else if (rowi rowl + 1) 
if (ealZ = coll 1) 
return dovnLeft; 
else if (co!2 « coll + 1) 
return dovnRightTwoBridge: 
else //coJ2“Coll 
return downRight; 
else //row2 == row) 

if Ecol2 ” col1 - 1) 
return left; 
else //C012 = coll + J 
return right; 

I // end GctDirccUun 
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Betterftith 

Path * Bet ter Path(Path *pathl, Path "path2. 

PathAction action) 

I 

long ratingl, rating?; 

Path * be tt e rPath, * wo r s e Pa Lh; 

// rale both path 

ratingl “ PathRating(pathl); 
rating? = PathRating (path!) ; 

// compare the ratings (low is better) 

if (rating! < rating?) 

I 

betterPath = path!; 
worsePath “ pathZ: 

J // end if 
else 

I 

hetterPath 3 path2; 

vorsePaih w path!: 

J // end ebe 

// dispose of the bad path, if directed to do so 
if (action = forgetBad) 

FreePath(worsePath); 
return hetterPath; 

] // end BmerPsnh 

KathRatlng 

long PatbRatingfPath 'path) 

1 

long rating; 

If (I path) 
return 4Q$6; 

// go to the beginning of the path 

for (; pas.h->prev: path = path->prev); 

// count the number of unoccupied locations 
for {rating = 0; path; path * path >next) 
if (path>occupied = faltsy) 
rating++; 
return rating; 

] // end Pith Rating 


Fiirnirtatened'lwoBridgc 

void FiliThreatenedTwoRrEdge(Path 'path, long threatRov, 
long threatCol. long 'row, long 'col) 

l 

// go to the beginning of the path 

for (; path->prev; path ~ path->prev): 

// scan through the path untU the threat is found 
for (; path; path = path->next) 

if (isTwQRrldge(path->nextDirectlon) && 

TvuBtidgeThrcatoned (path - >row. path >col* 
threatRov* thieatCoi, path >nextDlrection)) 

I 

// try all moves until we find one tlul QJU 
// the two-bridge (sorry. U s the easiest way 
ff way to do it) 

Direction d: 

Boolean done; 

for (done = false, d = 0; I done && 
d < noDieeetian; d++) 

I 

FindUewLocation(path->row. path >col* 
d. row. col): 

ff make sure we're not making the same move 
ff as the opponent 

if ( Two R r1 dgoTh re a t en ed(p a th - > row« 
path->col. * row* *col* 
path->nextDirccLion) &5i ( p row ! = 
threatRov |] # col I® threatCol)) 

done = true: 

) //end if 
| ff end for 
I //end if 

: ff end fiUThrcatcncdTwi^Rridge 
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TakeDctour 

Path ‘T&keDetourdong boardSlze, Chip 'theBoard. Path 'path, 
long row. long col* Chip color) 

Boolean centorPassed : // have we passed the center? 

Boolean blockFound; // have we located the disruption? 

Path ‘corruptPath: // the part that was blocked 
Edge edge; 

// go to the beginning of the path 

for £; path->prev: path “ path->prev): 

// find the location of the disruption 

for (centerPassed = blockFound = false; path kL 
IblockFound; ] 

1 

if (patb->center) 
centerPassed ■ true: 

if {IsTwoBridge(path >nextDireetion) && 

TwoBridgeThreatened [path^rov, path->col, 
row, col, path->nextUirection)) 

if (centerPassed) 
path - psth->next: 
blockFound = true; 

] //end if 

else if (row path >row && col — path->eol) 
blockFound " true; 
else 

path - path->next; 

J //end for 

// free from there to the end 

if (centerPassed) 
f 

corruptPath * path; 
path “ path>prev; 

path->next - corruptPath->prev = nil; 

FreeFath(corruptPath): 

) ff end if 
else 

i 

corruptPath * path; 
path * path >next; 

corruptPath->next = path->prev = nil; 

FreeFath(corruptPath); 

1 //end rise 
if (color “ blue) 
if (centerFassed) 
edge - bottoraEdge; 
else 

edge " topEdge: 
else // color is red 
if (centerPassed) 
edge * rightEdge; 
else 

edge “ leftEdge; 

// extend the path from there to the edge 

if (lExtendPatbToEdge£boatdSize, theBoard* path, edge)) 

( 

// if not possible, destroy the path 

FreePath(path); 
path * nil; 

] // end if 

return path; 

I // end TiikeDtftour 


FindBestMove 

void FindBestHove(Path *ourPath. Path ‘oppPath, long *row, 
long *col) 

( 

// ratings for our path, the opponent s path, and the 
// two halves of the better (used) path 

long ourRating, oppRating, prevRating - 0, 
nextRating * 0; 

Path 'usedPath, ‘tempFath, 'unusedFath; 

// don't even Uy to continue if there arc no paths 
if (loppPath && loutPath) 
return: 

// see who has the better path 

ourRating - FathRating(ourPath): 

□ppRatlng * PathRating(oppPath); 


if (ourRating < oppRating) // ours is better 

UsedPath - ourPath; 
unusedFath - oppPath; 

) 

else 

f 

usedPath ■ oppPath; 
unusedFath = ourPath: 

1 

// first try to make a move which is both offensive and defensive 
tempPath - usedPath; 

// go to the beginning 

for {; tempPath->prev; tempPath ■ tempFath>prev): 

// find the first unoccupied piece 

for (: tempPath && tempPath->oecupied; 

temp Path 111 tempPath-/prev) 

l 

// see if it is in the other path, also 
if (HovelnPath(unusedFath, terapFath->rov, 
tempFath->coI]) 

1 

‘row * tempPath-)row; 

*col “ tampPatb‘^col; 
return: 

J 

I 

// look for unoccupied pieces 
tempPath “ usedPath; 

U go to the beginning 

for (; tempPath->prev; tempPath “ tempPath >prev): 

// go to the center 

for (: !tempPath->centct; tempPath = tempFath->next): 

// rate the first half 

for (; tempPath; tempPath - tempPath->prev) 
prevRating !tempPath'^occupied; 
tempPath = usedPath; 

// go to the beginning 

for £: tempPath->prev; tempPath " tempPath->prev); 

ff go back to the center 

for £; ! tempFalh >eenter; tempPath = tempPath Onext); 
ff rate the second half 

fur (; tempPath: tempPath - tempPath->next) 
next Rating += !tempPath->oceupied; 
tempPath = usedPath; 

// go to the beginning 

for (: tempPath >prev; tempPath ’ tempPath->prev); 

// go to the center 

for (; ItempPath >center: tempPath =■ tempPath - >iiext); 
ff make a move on foe side with the worse (high) rating 
if (prevRating > nextRating) 

// find die first unoccupied piece 
for £; tempPath && tempPath->oecupled: 
tempPath “ tempPath-)prev): 

else 

if find the first unoccupied pk-ce 

for (; tempPath && TempPath->occupied: 
tempPath - tempPath*>next); 

IF (tempPath) 

( 

"row ** temp Path -> row: 

*col ” tempPath->col; 

I //end if 

else //no unoccupied pieces anywhere 

I 

ff if there are none, fill in any unconnected two bridges 

for (; usedPath >prev; usedPath - 
usedPath->prev); 

for (; usedPath && !IsTwoBridgel 
usedPath->nextDirection); 
usedPath = usedPath >nrixt); 
if £ usedPath) // should always be True 

// try all moves until we find one that 
ff fills the Two-bridge (sorry, its die 
ff easiest way way to do it) 

Direction d: 

Boolean done: 

for (done “ false, d - 0; Idone && 

6 < noDireciiou; 13 ++) 
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( 

FindHewLoca tion (usedPath - > row. 

usedPath >col, d* row. col); 
if (TvoBridgeThreatened(usedPath->row, 
usedPath'>col, *rw. 'col, 
usedfath'>nextBirecticn)) 
t 

done true; 

) // end if 
J // end for 
I //endIf 
] //cikIcUc 
} // end FindflestMovc 


NextToEdgc 

Boolean NextToEdge{long row. long col. long boardSize* 

Edge edge) 

{ 

switch (edge) [ 
case leftEdge: 

return col 1: 
case rightEdge: 

return col " boardSize - 2; 
case topEdge: 

return row — 1: 
case bottomEdge: 

return row ** boardSize 2; 
default: // should never get here 
break; 
l // end switch 
J // end NextToEdge 

Dynamic Memory4.c 

typedef struct Header 

f 

long 

size: // the size in bytes of rhe block 

struct Header 

*prev. // the previous block's header 
•neat: //(he next block's header 
\ Header; 

void InitializeHeap(Header 'heapStart. long size); 

void ChopBlock(Header 'theBlock. long fragSize); 

void *AnocateBlock(long size); 

void Fusefilocks(Header 'block); 

void FreeBlock(void Mata); 

void HeapSununary (void) : 

Boolean IsPointerValidivoid Mata); 
void SetHeap(Header 'start); 

Header 'GetHeapCvoid): 

Header 

‘gRcapStart: 

long 

gFreeBlockSn 
gUsedBlocks, 
gFreeSpace. 
gllaed Space. 
gTotalSpace; 

void InitiallzeHeap 

( 

// these arc assumed to be valid; no error-checking b performed 
Header *heapStart, // the address of the start of tile heap zone 

1on g size //the size of the zone 

* 

heapStart’>size " size - sizeof (Header); 

// mark the size of the zone 

heapStart >prev c nil; // mark as being the first block. . 

heapStart->next = nil: //. . and the last 

gHeapStart * heapstart: // initialize the global heap sun pointer 

1 

void ChopBlock 

( 

// these are assumed to be valid; fragSize must be less than theBlock*>size 

Header * the Block. // the block to chop 

long fragSize // the size of the first new fragment 


Header 

‘newBlock; 

nevBlock » (Header *) (((char *) theBlock) + sizeof 
(Header) + fragSize): 

newBlock->Bize = theBlock*>size * fragSize - aizeof 
(Header); 

ft the remaining space 

newBlock->prev theBlock: // newBlock comes after theBlock 
newBlock >next ” theBlock >next; 

// it gels inserted between theBlock and theBlock >ncxt 

if (theBlock->next) 

iheBlock->next->prev * nevBlock; 
theBlock' > size - fragSize; // tlicBlock gets just what was asked for 
theBlock->next - newBlock: // its new next block is newBlock 

\ 

void ‘AllocateBlock 

( 

1 on g s i z e //the size of the desired block 

) 

I 

const long 

BU3CK_Ttf_tISE_HA£K - GxBGQQOOOQ * // if this hit is set in the k sb* field, 

// the block is in use 

M1N_BL0CK_SIZE - SO; // the smallest usable block (board data + pointers) 
Header 

'curesntBiock; //a pointer lo the block cuntnUy being considered 

eurrentBlock = gHeapStart; 

// loop until either there are no more blocks or a fitting one is found 

while (eurrentBlock && ((eurrentBlock & 

BLOCK_iN_HS£_MASK) || (eurrentBlock >aize < size))) 
eurrentBlock ” eurrentBlock->next; 

if (eurrentBlock) // a valid block was found 

l 

// if the block is much bigger than needed 

if ((eurrentBlock >size size) > 

{MIlOLQCJCSm + aizeof (Header))) 

Cho pE 1 o c k (c u r r en t B1 oc k * size); // cut off a piece of exactly the 

ft right size 

currenxBlock->size j= BLOCK_IN_USE_MASK ; //mark as being in use 

// return a pointer to just after the block header 

return (char “) (eurrentBlock + l); 

I 

else 

// indicate that allocation foiled 

return nil; 


void FuseBlocks 

( 

Header *b 1 o ck // the block to fuse with its following neighbor 

) 

I 

Header 

'neighbor; 

neighbor « block->next: 
block-)next = neighbor->next; 
neighbor->next->prev ” block: 

block->slze +" eizeof (Header) +- neighbor->size: 

// blocks must not be in use 


void FreeBlock 

( 

void 

* da ta if the block of data to fret, fusing with its neighbors if possible 

) 

( 

const long 

BLOC K„1N_U SE_HASK = 0x60000000; 

// bit in size field used to indicate use of blocks 

Header 

'theBlock: // the data block's header 
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// the header is located just before the data 

theBlock = ((Header *) data) - 1: 

// assumed to he in use, with flag set; here it is reset 

if (theBlock >size 6 BLOCR_IN_USEJ4A3K) 
theBlock->size -= BLOCOOSEJIASK; 

// if there is a next block and it is free 
if (theBlock->next && 

!(theBloek->neatt->eiae & BLQCK_DJ_USE_KASK)) 

FuseBIocks(theBlock); 

U if there is a previous block and it is free 

if (theBlock >prev kh 

!(theBlock->prev>size k BLOCK_lN_USEJtASK)) 
FitseBloeks (theBlock- >prev); 


void HoapBumiriary 
void 

) 

f 

const long 

IN USE MASK - OxfiOOOOGOO; 

Header 

‘block: 

block - gHaapStart; 
while (block->next) 
block * block->next: 

gFreeBloeks = gUsedBlocks = gFreeSpace = gUsedSpace “ 0; 
while (block) 

I 

if (block-)size & IN_USE_MASK) 

( 

gIJsedBlocka++: 

gUsedSpace += block->«ist TN USE MASK ; 

1 

el^e 

I 

gFreeBlocks+t; 
gFreeSpace t“ block*>size; 

I 

block = block >prev; 

1 

gTatalSpace - (gFreeBlocks + gUaedBlocks) * 

sizeef (Header) + gfreeSpace + gUsedSpace; 


Boolean IsFointerValid(void ‘data) 

( 

Header 

*theBlock. 

‘compRloek; 

theBlock “ ((Header *) data) 1; 
compBlock = gHeapStart; 

while (compBlock && compBiock !- theBlock) 
compBlock * cotnpBlock->next: 

if (compBlock == theBlock) 
return true; 
else 

return false: 

1 

void SetHeap(Header ‘start) 

I 

gHeapStart = start; 


Header ‘Cetlleap (void) 

I 

return gHeapStart; 

I 

Storage,h 

typedef struct Header 
I 

long 

size, // the size in bytes of the block 

inUse; 

struct Header 

* p r ev * // liic previous block s lirade r 

‘ next , if the next block's header 

* p revF t ee. // the previous free block 

* n o x i F r ce; // the next free block 
] Header; 

void AddToFreehist(Header ‘block); 

void RetnoveFronFreeList (Header ‘block); 

void InitializeHeap(Header *heapStart. long size); 

void ChopBlock(Header ‘theBlock. long fragSize); 

void *A1 locateRlockflong size): 

void FusoBloeka(Header ‘block) : 

void FreeBlocktvoid ‘data); 

void SetHeap(Header ’block) ; 

void SetFreeStart(Header *freeStart); 

Header ‘GetFreeStart(void): 


THE RULES 


Here's how it works: each month we present a new programming 
challenge. First, write some code that solves the challenge. Second, optimize 
your code (a lot ). Then, submit your solution to MacTech Magazine. We choose 
a winner based on code correctness, speed, size, and elegance (In dim order of 
importance) as well as the submission date. In the event of multiple equally 
desirable solutions, we'll choose one winner (with honorable mention, but no 
prize, given to the runner up). Hie prize for each month’s best solution is a 
$100 crediL for Developer Depot™. 

Unless stated otherw ise in the problem statement, the following rules apply; 
All solutions must be in ANSI compatible C or C++, or in Pascal We disqualify 
entries with any assembly in them (except for challenges specifically stating 
otherwise.) You may call any Macintosh Toolbox routine (e.g„ it doesn't matter if 
you use NewPtr instead of mailoc). We compile all entries into native PowerPC 
code with compiler options set to enable all available speed optimizations. Tire 
development environment to be used for selecting die winner will be stated in the 
problem, limit your code to 60 characters per line or compress and binhex 


the solution; this helps with e-mail gateways and page layout. 

We publish the solution and winners for each month's Programmer's 
Challenge three months later. All submissions must lie received by the 1st day of 
the month printed on the front cover of this issue. 

You can gel a head start on the Challenge by reading Lhe Programmer s 
Challenge mailing list. It will be posted to the list on or before the 12th of the 
preceding month, To join, send an email to listscrv ^listmail .xplain .rom with the 
subject ‘'subscribe challenge A". 

Mark solutions "Ann: Programmer's Challenge Solution* and send it by £ 
mail to one of the Programmer s Challenge addresses in the "How to 
Communicate With Us” section on page 2 of this issue, include the solution, all 
related files, and your contact info. 

MacTeeh Magazine reserves the right to publish any solution entered in 
die Programmer's Challenge. Authors grant MacTeeh Magazine the exclusive 
right to publish entries without limitation upon submission of each entry 
Authors retain copyrights for the code. 
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David Hempling and the Latitude Porting Libraries 


This month's interview is with David 
Hempling, founder of the Latitude Group and 
Quorum Software Systems Ixrfore thaL. If you 
have not yet heard about the Latitude porting 
libraries, you owe it to yourself to read this 
interview. The current version of Latitude 
makes it easy to port your Macintosh 
applications so they run under Unix. 
Recently t Metrowerks purchased llie latitude 
Group with an easy port from Mac to 
Rhapsody in mind. Read on to learn more... 

Dave M: Can yon tell me a bit about the 
history of The Latitude Group? 

Dave H: The Latitude Group was founded in 
August of 1994 to continue development 
and support of the Latitude Technology 
which was originally developed by 
Quorum Software Systems, Inc. 

Back in 1989 Sheldon Breiner, an 
entrepreneur with several companies 
under his belt, wanted to create a 
Macintosh hardware clone. As you can 
imagine, he found no one who would 
join him in such a venture. He eventually 
meet up with R, Martin Chavez, a 
Computer Science PhD and medical 
student, who had ideas alxnit enabling 
Macintosh applications to run on other 
platforms. Marty's idea was very unique: 
under some special process, the shrink- 
wrapped Macintosh application would 
take on the native look and feel of the 
non-Mac platform on w r hich it was 
running. Sheldon and Marty, with myself 
and another software engineer, Joel 
Kehle, founded Quorum Software 
Systems and began development. 
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Our first objective was to implement key Macintosh Toolbox 
functions in our own portable library — the beginnings of 
latitude. We would dien couple this library with a 680x0 
interpreter which would interpret the Macintosh binary 
executable and defer to our portable library when the 
interpreter encountered an A-Line trap exception, Mac 
programmers from the old days will remember that this is how 
Mac programs worked. Application machine code contained 
OxAXXX iastructions which triggered a 68000 exception. The 
lower 24 hits of the OxAXXX instruction were used as an offset 
into the Mac’s Trap Table and execution would jump to a 
function inside the Mac ROMs. 

We did our initial portable Mac Toolbox library development on 
the 68050 NeXT Cube while another engineer, Robert Brown, 
developed a portable 680x0 and Microsoft P-Code interpreter. 
With the interpreter working, we moved our development to 
RISC based UNIX platforms like Sun Solaris, SGI IRIX, and HP I IP- 
UX and released Equal, the Application Adapter which brought 
Microsoft Word 5.1a and Excel 4,0 to UNIX, Under Equal, 
Macintosh Won! and Excel binaries ran on those non-Mac 
platforms with great performance and a naLive lode and feel. 

Because our portable Mac Toolbox library' was being used to 
support two world-class applications, ii was imperative that our 
Toolbox implementation behave as accurately as possible. We 
didn't have the Word or Excel source code to refer to — only 
the sequence of Toolbox calls these applications were making. 
'This black-box method of development, and adherence to stria 
dean-room engineering with regards to Apple's closely 
guarded Mac ROMs, led us to establish coding practices and 
design guidelines that we’ve continued to follow through our 
development of the portable Mac Too]lx>x library: 

1. With regards to application reliance on Mac Toolbox 
function input and output, our library's implementation 
must match the Mac and use published Mac data 
structures and paradigms internally whenever possible. 

2. Map native system facilities to Mac Toolbox functionality 
so the resulting application has the look and feel of the 
native platform. 
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3- Require as lithe modification to the application as 
possible. Under Equal, there was really no practical way 
to alter rhe application’s instructions, We had to 
implement Toolbox functionality correctly in our library 
so Lhai no application modification would be needed. 

Quorum also begin to license the portable library used by 
Equal to Mac developers who wanted to bring their 
applications to UNIX without the added overhead of the 680x0 
interpreter Developers also wanted the option to break out of 
their application's Mac source base and take advantage of 
features available in the new UNIX/RISC machines coming 
into the market. Quorum called the portable library “Latitude" 
and signed up developers like Adobe, Micro Planning 
International, and Sonic Solutions, 

Early in 1994, Quorum’s sales did not meet with its investors 
expectations and Quorum dosed its doors that July. However, 
there were still developers using Latitude. Adobe, for example, 
was preparing to release Photoshop 2.5 at that time and needed 
Latitude support. Joel Kehle, myself, and three other Quorum 
engineers founded 'Ihe Latitude Group, Inc., licensed Latitude 
from Quorum, and supplied Quorum’s Latitude clients with 
support We later purchased Quorum's assets from the fire sale. 

Over the next two and a half years, we continued to develop 
Latitude, upgrading and expanding the technology as well as 
our client base, Adobe continued to use Latitude to bring 
Illustrator 5.5 and Photoshop 3-0 to Sun Solaris and SGI IRIX. 
Other more vertically minded developers like Vibro-Acoustic 
Sciences used Latitude to bring their highly specialized tools 
to UNIX/RISC platforms. 

Dave M: How does Latitude work today (before Rliapsody)? 
How do I get my existing Mac application ported over to 
Unix? How much work Is involved? 

Dave H: At the heart of Latitude is our own Portable Toolbox 
Implementation layer This layer is completely platform 
independent. It presents the Mac Toolbox API to the 
application, answers these calls through a trap table 
mechanism, and relies on other toolbox calls within the layer 
whenever possible. When a native system facility is needed, 
such as the display of a window or control, or some graphical 
rendering, this layer calls out to one of Latitude’s platform 
dependent modules through an internal, well defined APL The 
toolbox layer doesn’t know what kind of system lies 
underneath, only that calling this function will display a 
window or that function will draw a line, etc. 

Likewise, regatding the platform dependent modules. Event 
feedback from the GUI platform dependent module comes in the 
form of special calls back to Latitude's Event and Window Manager 
implementations* These calls in turn place event records in 
Latitudes Event queue. Latitude’s architecture also strives to 
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reconcile the difference between the Mac event and rendering 
systems and those on the platform Latitude is delivering. For 
example, client/server systems like Motif or OPEN Step use 
callback mechanisms to report events to applications. A button's 
callback is called when the user clicks on tlx. 1 button. Latitude’s 
GUI layer button callback function places a mouse down and 
mouse up event in Latitude’s event queue* A window’s update 
callback in the GLU calls down to the toolbox Window Manager to 
invalidate some or all of the window's update region, which is 
then picked up by CheckUpdateO from the app’s call to 
GetNextEventQ or WaitNextEventO- 

Because we’ve mapped native system facilities to Mac calls, the 
running application is an equal citizen on the desktop. The 
application’s windows, menus, and control items are native system 
objects. Cutting and pasting between apps is facilitated by the 
native system’s clipboard mechanism. Fonts come from the system 
font server — including the default system font, which means the 
dialogs come up in something other than Chicago! Application 
windows are native windows — not some rendering of a window 
inside of another The performance hit Is minimal. Latitude is 
merely mapping die Mac calls to the native system. There is very 
little processing going on in between. 

To bring a Mac application to UNIX using Latitude, you first 
bring die source code to the UNIX platform and compile it. 
Tools included with latitude perform some of tire more 
mundane tasks like generating Make files and replacing l \p T 
Pascal string delimiters with special macros. Any changes 
made by these utilities can lie taken back to the Mac without 
any ill effects. The goal is to generate Ixnh your Mac and UNIX 
applications from the same source code tree. 

The bare minimum modification you will need to make to 
your application is a call to initialize Latitude. This call is 
equivalent to booting a Mac and double clicking your 
application’s icon, sets up Latitude’s internals, and prepares 
it for your application. 

If your application contains compiled CDEF, MDEF, LDEF, 
MBDF, or WDEF resources, you will have to register these 
functions with Latitude and compile the definition function 
with the rest of your application. If your application contains 
any 680x0 or PPG assembler axle, you will have to write 
equivalent code in your application’s programming language. 

Assuming your application is SysLem 7 compliant (no nil 
pointer de-references, no low memory global accesses by 
address, etc*) there is little more for you to do than to compile 
the source code and link with Latitude’s library* By specifying 
the location of support files in system environment variables, 
your Latitude ported application should find what it needs and 
begin running. The rest is testing and tweaking. 
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Of course, there are many ways io utilor your application's 
appearance and behavior by adding some additional latitude 
auxiliary calls. For example, Latitude supports floating palettes 
and windows for applications that provide custom WDEFs 
and/or patch Window' Manager functions like FrontWindowO 
and SendBehindO- But there are so many different ways 
applications achieve floating windows that we can't ensure that 
latitude supports them all. Instead, we provide special auxiliary 
calls which help your application tell Latitude which windows 
should float and when. Other auxiliary calls help tailor window 
behavior, adornments, and appearance. Still others help to 
solve the different structural alignment padding rules that differ 
between the Mac and other platforms. 

Dave M: How much of the System 7 API does Latitude 
currently support? Ls Quickdraw supported, for example? 

Dave Hi Over 1,200 Macintosh Toolbox functions are 
implemented in Latitude. These include all of System 6 and a 
majority of functions introduced in System 7 except some of 
the newer System 7 calls. All of the user interface (windows, 
controls, menus, cursors, lists, events, etc.) calls arc 
implemented as well as calls for resources, hie i/o, text and 
script managers for Roman character sets, scrap, printing, 
drag-n-drop, and various utilities like SANE, OSUtiLs, the Time 
Manager, etc. 

Latitude's Quickdraw implementation is one of its crowning 
achievements! Pictures, icons, color patterns, and off-screen 
graphics are automatically transformed onto native canvases. 
High quality dithering of 24-bit pictures for 8-bil buffers is 
automatic. Latitude’s drawing occurs through its own set of 
the standard QDProcs. All pen functionality, including 
pixmap patterns, are supported. Latitude passes rendering 
operations to the native platform when ever possible to 
obtain top performance. But we also can render drawing 
operations completely in memory before being transferred to 
the native rendering system. This lets us support arithmetic 
modes in CopyBits that systems like X or DPS can't provide. 
Besides supporting CopyBiLs, CopyMask, and 
CopyDeepMask, Latitude's Quickdraw handles pixmaps from 
devices with different color byte orderings. 

Latitudes picture recording and playback mechanism is 
completely integrated in the Quickdraw system. It reads 
Version 1, Version 2, and Version 2 Extended PICT formats and 
writes Version 2 PICTS. Latitude's PICT Interpreter has the 
ability to perform translation between Mac Regions and 
Latitude's own region implementation. 

Latitude also supports GDeviees of varying depths and color 
byte orderings. It's also possible to create GDeviees with 
drawing area memory which is shared with the native 
platform image memory. This allows for extremely fast 
drawing performance. 
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For printing, Latitude has a set of QDProcs that generate 
PostScript that is written Lo a file and then sent off to the local 
or networked PostScript Printer. We are using some of this 
code to build our DPS rendering module for Rhapsody, 

Dave M:How do I get to traps that Latitude doesn’t 
support? Can 1 access the native APIs with a project 
that uses Latitude? 

Dave H: There's nothing in Latitude that keeps apps from calling 
the native system directly. In fact, tills kind of design is 
encouraged. Many times there are system facilities that have no 
equivalent in Mac Toolbox land. Latitude can lx: used then as a 
transitional tool. Developers can use it to make the first jump, 
put out a dot release, and then write more and more native code 
to take advantage of the new and evolving plaLform. 

Latitude does have auxiliary calls to help apps access Mac- 
Toolbox windows through their native counterparts. For 
example, given a WmdowPtr, a special Latitude call will return 
the native object for Dial window. The app can then address 
the window directly. There arc also calls to intercept events 
before Latitude processes them so that apps can manage Lheir 
own windows outside of Latitude. 

Dave M: I know that latitude Is written in ANSI C Can I 
access the Latitude library from any language, including 
C++ and Objective C? 

Dave H: Once Latitude is integrated into Code Warrior and included 
in the CodeWarrior library set, you should be able to use it with 
any language supported by CodeWarrior, Latitude is currently 
built with GNU gcc but can also be built with the native Solaris 
SPAKCWorks compiler and SGl's native compiler. 

Dave M: If I use latitude today to do a Unix port of my 
Macintosh application, will I get a free ride to Rhapsody 
once the Rhapsody version of Latitude Ls ready? Any 
idea of w hen that w ill be? 

Dave 11: As 1 said, one of the main goals of Latitude is to allow 
developers to get to many platforms with one code base. The 
idiosyncrasies of the platform are handled by Latitude's 
platform dependent modules. The APT to the application 
remains the same, There are already Latitude dienes who build 
their apps on SGL SUN, and IIP platfonns without modifying 
their Mac code base, Of course, if platform specific work has 
been done inside the application, then this code wall have to be 
swapped out when moving to the new r platform. 

Work on bringing Latitude to Rhapsody has already begun. 
We re also keeping close tabs on how Apple plans to shape 
Rhaposdy so that Latitude will be in line with what eventually 
comes out of Infinite Loop. 
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Dave M: Does Latitude hide the specifics of the file system 
— Le., will Macintosh HFS calls like StandardGetFileO or 
the various PB caUs port? 

Dave H: All of the PB anti FSSpec calls U> access files have been 
implemented in Latitude. Files in the native file system are 
accessible as well as Mac HKS floppies. For native files, Finder 
and catalog information is picked up if die Files are in one of 
the various formats developed to represent Macintosh Files 
under UNIX, Typically, the data and resource forks are in 
separate files and the file’s Finder information is either 
included in the resource fork or kept in another separate file. 
Latitude understands many of these formats including 
AppleDouble, AppleSingle, Helios EtherShare, IPT uShare, 
and Xinet K-AS hare. Files without resource forks or Finder 
information appear as plain text files. 

Latitude supports all of die Standard File Package, both System 
6 and System 7 calls. It supports all of the customization 
applications typically make to that package’s dialogs and also 
makes a few customizattons of ils own to allow the user to 
access files through die native File system. These Latitude 
customizaLions are done liehind the scenes of the file dialog 
and do not interfere with any application customizations. 
There's even a special callback scheme in place so that apps 
can provide dicir own code to call the native get/put dialog 
and return a native path to the Standard File Package which in 
turn will fill in the appropriate reply record and return if to the 
app. 

Again, auxiliary calls are available in latitude to give access 
to the native File system by the app. There are calls, for 
example, to translate FSSpec formatted input into native File 
paths and vice versa. 

Dave M: What won't port? 

Dave II:Usually, not well behaved apps have the most 
problems. Apps that draw directly to the frame buffer or 
access private Mac structures, like RgnHandle data or low 
memory globals by address. Crawling up the slack frame 
using the A5 global obviously doesn't work. Basically all of 
the things that the Inside Macintosh books say not to do are 
no-nos in Latitude, 

Memory Manager work-arounds don't port over well either. 
Some apps have the habit of seeing how much memory is 
available and then allocating all of it for themselves. On UNIX 
based systems, this kind of practice really doesn't make much 
sense. By disabling this kind of mechanism and simply relying 
on Latitude's Memory Manager calls to allocate memory, apps 
are assured of efficient memory usage. 

Dave M: Are there any big-name apps that are currently 
using Latitude? 
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Dave H: As 1 mentioned earlier, Adobe has used Latitude to 
bring Illustrator 5.5 and Photoshop 3,0 to Sun and SGI. The 
Latitude Group's dose work with Adobe on these projects 
helped us fortify Latitude a great deal. We’ve found that other 
folks using Latitude benefited enormously from the work we 
did on Photoshop — the app Greg Gala nos likes to call "die 
Mother of all apps*. 

Later tills year, Adobe plans to begin shipping their non¬ 
linear video editing software, Premiere, on SGI's new 02 
platform. From the looks of Premiere on the 02 today, this 
is going to be one hot product! Latitude enabled Adobe’s 
engineers to skip past all of the user interface support and 
go straight to tuning Premiere's audio and video technology 
to SGFs amazing 02 and add a few video features thaL die 
Mac simply can’t handle as well. 

Other Latitude clients include more vertical market apps by 
developers who wanted to get to the graphics power of the 
SGI or the server power of the Sun or HP platform line. These 
apps include video and audio processing for the Film industry, 
audio and sensitive vibration measurement and analysis for the 
automobile industry, and advanced photographic processing 
technologies used for film development and film products. 


Dave Hempling grew up in Villa Park, CA, a small 
suburb of Orange County where the 91 meets die 55. 
Between 1983 and 1988, while earning his Computer 
Science BS at UC .Santa Barbara, he worked pan time at 
Digital Sound Corporation, putting his early teenage 
phone phreaking experience to good use at one of the 
first developers of voice mail, Dave came to the Bay Area 
in 1988 and did a couple of short stints at Bell Northern 
and Analog Design Tools before meeting up with Marty 
Chavez and starting a small consulting concern with him. 
That’s when they met Sheldon Breiner and started 
Quorum Software Systems in late 1989, The rest, as they 
say, is history. 

For fun, Dave enjoys modern rock, pop, jazz, and is a 
regular at the symphony. He h s a big fan of cartoon classics, 
Animaniacs, anything out of the folks at Pixar and 
Skelington Productions, dark, dry humor, and w p ackv 
nonsense. He enjoys discovering the rhythms and melodies 
that come from living. Roller coasters and simulators are 
big favorites and the recently discovered joy of SCUBA 
keeps Dave busy when he's not coding, E3Q 
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by Michael Rutman, independent consultant 


ObjectWare 


Selling your technology to 
developers as a drop-in 


What is ObjectWare? 

As functionality in different ap¬ 
plications sum to overlap, many pro¬ 
grammers are forced to reinvent existing 
technology, Most modem word processors 
have drawing packages built into them, and 
most modern drawing packages have word 
processors built into them. Normally* each 
developer must create both a word 
processor and a drawing package. With 
ObjectWare, the philosophy is to create a 
great word processor object, which can be 
dropped inLo any application and then sell 
it to application developers. 

Why is ObjectWare a philosophy rather 
than a technique? There are many techniques 
to add technology to an application, ranging 
from shared libraries to publicly sold source 
code. ObjectWare differs in the process. If an 
application Is already object oriented, and 
you can isolate die objects needed to use a 
technology, then those objects can lx* easily 
bundled and resold. Not only can you sell 
your application to end users, but you can .sell 
your technology to other application 
developers. Using shared libraries is a 
technique for doing ObjeaWare. 

OPENSTEP's support of ObjectWare is 
done through custom palettes for 
InterfaceBuilder. A palette is a bundle of 
object files* interface files* and any other 


resource that InterfaceBuilder would need to add the technology 
to an application. Once loaded into InterfaceBuilder* ail the 
functionality of the custom objects are accessible as if NeXT had 
bundled them into InterfaceBuilder in the first place. 

NeXT provides a wonderful tutorial, c alled CustomPaletle,rifd 
I have been assured that this documentation will Ixcomc available 
to all Macintosh developers soon, Many of die details, as well as 
source code, for implementing custom palettes* which are the user 
interface to an ObjectWare package, are located in that tutorial. 

The code in this article is built using NEXTSTEP 3-3 for Lite 
development, and all coding is done in Object ive-C. OPEN STEP is 
slightly different* and Rhapsody has not been fully defined as of 
the w riting of this article. 

How do I use ObjectWare? 

tinder OPENSTEP, ObjectWare is easier than ever before. 
Adding a new technology to your application can be as easy as a 
double-click and drag and drop. Bundled objects are built with 
palettes and then can be loaded into InterfaceBuilder Once 
loaded into Interface Builder, they can be dragged into your UI just 
like any existing OPENSTEP object. At that point, there is no 
difference between adding a button, a graph or any other object 
to your application. To load the libraries, just drag and drop the 
library into your project* and iris ready for compilation. 

Unfortunately, as a developer you w ill probably have ro write 
some code. Not always, though* as there am some Objects that just 
work and require no setup. A graphing object* for example, will 
probably require some custom code to interact between the user 
and the application. On the other hand, an ObjectWare package of 
pretty buttons could be hooked up to your application using 
InterfaceBuilder without any axle changes. 

Related to ObjectWare is loadable bundles. Loadable 
bundles are functionality that can be added to existing 
applications at run Lime, Metrowerks and Adobe Plugins are very 
similar to loadable bundles. 


Michael Kulrnan is a software developer with experience developing for several platforms, including Macintosh, NEXTSTEP, 
Newton, Pilot, and Window s NT. While working at Soft w are Ventures, he lead the development of Snatcher and Microphone Pro 
for NEXTSTEP. He also worked on the MieroPhone Pro for Macintosh product line. He now works as an independent consultant 
on a variety of projects including encryption, compilers, web based add-rotation software, and ship stevedoring. To contact 
Michael Ruunan send mail to moose@maniem< xxse.com. 
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Cheating .an ObjectWake Palette 

Object Ware under OPENSTEP requires an InterfaceBuilder 
palette and a library, both of which are created using 
ProjectBuiider. When ProjectBuiider creates a new project, it will 
ask for a project type such as palette, bundle, library or 
application. When creating a palette, ProjectBuiider will create a 
folder, a nib (InterfaceBuilder file), and some starting source files. 

The starting source files ProjectBuiider creates will be enough 
to load custom objects into InterfaceBuilder, Unlike Constructor 
on the Macintosh, these objects are more than placeholders. 
InterfaceBuilder allows user interfaces to be tested without adding 
any code. An example of this is die Text Object. Many times 
OPENSTEF’s power has l>een demonstrated by placing a Text 
Object in a window' and testing it from InterfaceBuilder. Without 
adding a single line of code, the Text Object is able to spell check, 
word wrap, place tabs, and many other features found only in 
more powerful text editors. Likewise, any Object Ware created wili 
be as full-featured from InterfaceBuilder as from any application 
they are used in. 

The starting source files created by ProjectBuiider are mostly 
complete. If you are adding only View elements, then you need 
not edit die starting source files. However, to add non-View object 
you must first associate it with a View object so InterfaceBuilder 
has a way to represent the object. This requires your overriding 
the finishInstantiateQ method and adding a line of code to 
associate each non-view object with a custom view. In other 
words, if there is a non-graphical object, both the non-graphical 
object and a custom view representing dial object must lie 
created. When the developer grabs the custom view and drags it 
to where it belongs, InterfaceBuilder will create die correct non¬ 
view object instead. The view object is required to draw 
something to provide feedback in InterfaceBuilder* 

When the project is created ProjectBuiider creates a default 
palette to represent your objects in InterfaceBuilder You must use 
InlerfaceBuOder to modify this palette to populate it with 
whatever interface elements are necessary for the ObjectWare 
package. Palettes can contain custom views, menus, windows, or 
objects with no interface element* Each element must have a 
subclass of view created and plated in the palette window. 

Basic palettes don’t require any special code to make them 
work, but more sophisticated palettes might. For example, your 
palette might have an Inspector panel where various attributes, 
such as initial settings, can be set. These attributes should 
probably )>e saved as the application is being built. Use of the 
Inspector and reading and writing attributes require custom code. 
OPENSTEP provides objects to help perform these tasks. One 
such object is typed streams, which are an interesting mechanism 
for saving and restoring objects with disk files. 

Typed Streams 

Typed streams are a private data format for archiving objects. 
Each object declares the types in the stream, then writes those 
types. Art object can declare another object, and write that object 


to the stream. In practice, it is usually easiest to write the 
document object to a stream, and have the document object s 
w'rite method declare all other objects. Listing 1 shows sample 
code that archives some integers and subsidiary objects. One of 
the powers of typed stream is not having to worry about big 
endian/little endian issues. Typed streams work correctly with 
everything but bit fields* 

Listing I: 

* read:(WXTyoedStteam*)stream 
I 

[super read:stream]; 

NXReadTypes( stream, ‘'ii**. fr total, kstepSise ): 
helperObject * NXReadObjeett stream ); 
return self: 

1 

■ vrlte: (NXTyj>edSlrean* ] stream 

I 

[super write:stream]; 

NXWriteTypes£ stream. “ii** firtotal. SstepKize }; 
NXWrlteObjeet( stream. helperObject ); 
return self: 

I 

Typed streams are very easy to implement, but they do liave 
some drawbacks. Each written stream must Ik 1 read correctly. In 
the read method, the code has to specify that it is reading integers. 
If the stream and die code don’t match* then the read will raise an 
exception* Typed streams support versioning, though, and each 
object can specify that objects version. So, if only one object 
changes, then that object would up its version number without 
any changes outside of that object, 

Another drawback of typed streams is the lack of random 
access. Typed streams are meant to be read in their entirety. Each 
object is created in turn. Deferred loading of part of a document 
would lie difficult. 

The final problem I have had with typed streams is lack of 
portability. Despite OPENSTEP running on Intel, HP, Sun, and 
now Macintosh hardware, some people still need Windows 
applications. Some developers also need the file format to be the 
same across their Windows and OPENSTEP applications* This just 
isn’t going to work. 

Inspectors 

Most objects will require an inspector to examine and modify 
attributes of the object in InterfaceBuilder. The inspector code is 
only used by InterfaceBuilder, but it is still important. 'There are 4 
inspectors for each object. Attribute, Connection, Size, and Help. 
Default inspectors are provided automatically if custom 
inspectors are not created. Custom Connection and Help 
inspectors are rarely used. 

Custom palette objects are identified by adding one or more 
of the following factory methods to the object: 

getlnspectorClassNamt? 
getConnectlnspectorClassWame 
getSiKelnspectorClassNaue 
^tHelpTnGpectorClassNaiLe 
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Factory methods are, for all intensive purposes, the same as 
C++ static methods. There are some differences, but most of 
those are implementation details. Here, factory methods are 
used to retrieve global objects. 

Each custom inspector object must be added to the palette 
project There is no theoretical limit on the number of custom 
objects that can be placed in a palette of a project, as each custom 
object identities which custom objects apply. Likewise, a custom 
inspector object can inspect multiple objects. 

Each custom inspector is an object and a nib hie, Interface 
Builder has a command for creating the nib and object 
templates. Unlike the palette object, the inspector objects 
require some code, but not much. 

The inspector object inherits Irani IBInspeaor, which has outlets 
for connecting to the inspector. Once these outlets are hooked up, 
then die object is able to communicate with InterfaceBuiider 

There are four methods that need to be overridden. The 
first is the in it method. The init method is called automatically 
by InterfaceBuiider and is responsible for loading the nib file. 
As well as the nib file, the init method can instantiate any helper 
objects it will require. 

The second method required is the wantsButrons method, 
InterfaceBuiider will call each custom Inspectors wantsButrons to 
determine if an OK and Revert button are needed. If the inspector 
is doing live updating, then there is no reason for the OK and 
Revert buttons to be present. Most objects don’t do live updating, 
but wait for the OK button to l>e hit. 

Tlie last two methods are OK and Revert, These methods are 
automatically called when the user dicks on the OK and Revert 
buttons. Both of these methods must access the API created for the 
custom object to set and retrieve values. InterfaceBuiider saves 
settings by writing objects into a nib file. When an application 
loads a nib file, the retrieval method unarchives the objects* In 
reality, every object displayed in InterfaceBuiider is an 
instantiation of the object that will appear in the application. 


Library 

The last step is to distribute the object files for application 
programmers to use. Unfortunately, the palette is only usable in 
InterfaceBuiider. Fortunately, die same objects used in the palette 
can be used in the library'. 

The hesi mechanism, but the least used, is to distribute the 
source code. Of course, every programmer wants to be able to 
fix bugs in other programmer’s libraries, but giving away your 
source code is rarely used. 

if there is only one custom object, then distributing the object 
file created by gcc will work. The object file can lx: included In a 
project without any problems. If there are many objects, then the 
objects can be linked into a library, ProjecrBuiJder can create 
libraries as easily as creating palettes or applications. Each 
directory can only hold one project, so a second directory will 
have to be created. 

The standard way of creating the libraries is to bundle the 
objects with any nib files needed. Again, ErojectBuikler can create 
Bundles automatically. Bundles are a collection of objects and, nib 
files, and other resources that can either linked in or loaded at run- 
lime. Shipping as a bundle allows applications to load 
functionality as needed. 

CoNcausiON 

With Object Ware, not only can developers market their 
technologies for other developers to use, but they can Incorporate 
ihe latest technologies without re-inventing the them. 
OPENSTEPs architecture and development tools make bundling 
technology simple. There is no set source code language, any 
resources can be included, any call made by an application am be 
made by Lhe custom objects. Furthermore, developers that are 
testing their interfaces in InterfaceBuiider using the custom 
palettes will see the objects live instead of an attract l>ox that 
might work once the application is done. 

Overall, ObjcctWare under OPFNSTEP opens possibilities 
that other platforms have long struggled la achieve. K3 


Dilbert" by Scott Adams 
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AND IN CONCLUSION, 
NEVER UNDERESTIMATE 
THE POWER OF 
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JAVATECH 


by Will Iverson, Apple Computer, Inc. 


Building Beans 


Building a better application 
quicker with JavaBeans 


Understanding JavaBeans 

Over the List few years, we've heard a 
lot about component technologies, or 
software broken up into discrete, mixable 
sections. From a certain perspective, this 
includes such a broad umbrella of 
component technologies as OpenDoc, 
OLE, ActiveX, VBXs, OCXs, MacOS 
Extensions (INITs), Photoshop Plug-ins, 
Netscape Navigator Plug-ins, Control Strip 
Modules, DCMDs, ami even BBEdit 
Extensions This is a remarkable list, and 
includes some of the most interesting and 
powerful technologies available. 

The latest entry to the field is one of 
particular interest to developers, 
JavaBeans, in the current incarnation, is a 
component architecture for development 
tool plug-ins. JavaSoft has hinted at plans 
to make JavaBeans spread further than 
tools — how this will pan out remains to be 
seen. Given the recent introduction of 
JavaBeans, this article will cover what a 
Java Bean is and provide a brief 
introduction of how to build a Java Bean, 

Most of the information provided in 
this article is based on the JavaBeans 1.0 
specification available from JavaSoft. The 
reader is advised to frequently check the 
JavaSoft site at <http;//www,java$oftxom/> 
to stay abreast of the latest revisions to 
the specification* 


To take full advantage of JavaBeans requires the use of the 
JDK I. I. which on the MacOS means you will need to use MRJ 2.0. 
By the lime tills article is printed, a developer release of MRJ 2.0 
should be available from <http://applejava.apple.com/>. 

What is a JavaBean? 

Taken directly from the specification: “a Java Bean is a 
reusable software component that can be manipulated visually in 
a builder tool." As of this writing, the only tool available for the 
Mac which comes dose to implementing the spirit of JavaBeans is 
Symantec Visual Cafe, and this is die program from which 
screenshots below are taken. 

The high level concept is simple — there is a modular 
component architecture for the creation of developer 
components. Although some mention is made of JavaBeans as a 
compound document architecture, there is virtually no support for 
end user manipulation. 



Figure L 


Will t verson is the Java and Components Product Manager at Apple Computer. His latest crusade is try ing to preach the fienefits 
of Java's “object level memory protection." You can reach him at ivefson@apple.iom or wiverson@ixjietcom.corn. 
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In the builder tools above, you will see three windows. The 
toolbar is it dumping of the available components, the visual 
designer is the current visual interface being worked on, and the 
pr<)perty 11st sh<)ws rhe editable va 1 lies of rhe se!ectec1 1 x>m pt menu 




Another critical element of JavaBeans is the capacity to link 
them together, to support passing events from one Java Bean to 
another as a way of triggering complex, possibly even cascading 
interactions. It's worth pointing out here that JavaBeans can be 
(and often are) not visually presented when the programming is 
running, A case in point is the example above — a “timer 11 
JavaBeans is a “visual” representation of a thread w hich fires at an 
given interval. The “timer event” is triggered when that interval is 
hit. When the “timer event* goes off, iL tells Lite progress bar to 
update itself to the value specified, in this case a hypothetical 
connection progress status from a connect object's method. The 
timer isn't visual to liic end user, bui it can be manipulated 
through the property sheet by the developer. 


You T ve probably already worked with some sort of visual 
builder tod — ResEdit and the Metrowerks PowerPoint 
Constructor are examples. There are two fundamental problems 
wi th me >st of the ma i nsl rea m tc x >1 s 1 1 ta t make t 1 tern 1 ess d 1 a n i dts 1 1 

1. You can’t add anything to the tool palettes. 

2. You have to switch lx j rween an environment for doing your 
visual design and writing your code (often having to dose the 
visual design document before being able to run from your 
coding environment. 

3* The visual form builder typically has no good way to associate 
code with the visual elements — typically strings or ID 
numbers are used, which can be a headache to track, 
especially for larger projects. 

4 . Visual elements are limited Lo human interface, such as 
buttons, dialogs and menubars. 

JavaBeans is designed to solve these problems. 

How do JavaBeans Work? 

Now that you’ve been given a taste of how a JavaBean is 
used, let’s take a Icxik at how a JavaBean Ls designed 

A JavaBean typically encounters three “classes 11 of people, the 
developer of the JavaBean (the ‘‘programmer”), the user of the 
JavaBean (the visual builder user), and the end user (or “client”). 
Note that the programmer and the visual builder may be the same 
person, but the assumption is that they are not. 


Why is Visual Cafe Not JavaBeans? 

When the Visual Cafe project was begun, JavaBeans 
didn't exist, Symantec worked with JavaSoft in designing the 
specification, but the bulk of the JavaBeans functionality, such 
as support for the new event model and .introspection, 
(described later in this article) weren't available until Lhc 
release of JDK LL In order to “hack” around this limitation, 
Symantec developed a series of “descriptor” hies. These \desc 
files are simple text files and can lie found in the 
“Components” folder next to Visual Cafe, If you’re interested, 
you can open these files up and take a look at how they were 
built. Symantec Visual Cafe 1.0,1 Includes a pdf file, describing 
the format of these desc files. 

For a JavaBean developer, as long as you stick to the 
JavaBean “design patterns,” also descrilxxi below, you should 
he fine in die long term. If you’d like to make your JavaBean 
accessible to Visual Cafe 1.0* you can take a stab at trying to 
figure out fhe format to the desc files, bin understand that these 
files are specific to Visual Cafe. The good news is that if you Ve 
done your job with the design patterns properly, you won’t 
care —* it’ll just make your life easier. 
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1. A programmer decides to create a JavaBean, either to share with 
(Others, to sell, or simply to make her code easier to reuse. 

2. The JavaBean is created using the Ja vaBeans design patterns, 

3. The JavaBean is packaged as a JAR file. 

4. The visual builder user adds the JavaBean to the her 
development environment's library with the “Add Component 11 
command or similar action. 

5. The visual builder user drags I he JavaBean from the 
component library to the project. 

6. The visual builder user sets the JavaBean properties and events 
with the visual builder or makes use of the JavaBean directly 
from traditional code. 

7. The visual builder user builds the application or applet and 
gives it to the client. 

8. The client uses the application, cither as an applet, an 
application, or even as a Marimba channel 


What Versions Of the MRJ Support Beans? 

The initial release of the JDK TO last year was less than 
ideal, and plagued by more than a few bugs, JavaSoft quickly 
realized that Java needed some quick patduip work, and 
came out with the JDK 1.02, essentially a bugfix version of the 
initial JDK specification, this is the version of tiie JDK which 
is incorporated into Netscape Navigator and is the foundation 
for the MaeOS Runt ime For Java (MRJ) 1.0. As anyone who has 
played with Java extensively realizes, JavaSoft didn’t fix all of 
the bugs, and that’s what takes so long for an implementation 
of the JDK to go final 

The MRJ 1.5, which may be available as. a final release by 
the time this article is printed, is an implementation of the JDK 
1.02 specification with the additional of the performance 
technology known as a JITc. Simply put, a JITc remembers that 
it has converted a section of bytecode to native code, and then 
caches that code. Typically, this results in an across the board 
CaffeineMark improvement of xlO, with specific benchmarks 
ranging from no effect to over x20. 

The MRJ 2.0, which will be available as a developer 
release this summer, is an implementation of the JDK 1/1, the 
new release from JavaSoft featuring a host of new features, 
many of which are required for Beans support, including 
Introspection, Reflection, RM1, Serialization, Inter- 
nationalization, and other technologies, 

The nice thing about the MR) is that it isolates the Java 
VM from a specific application. You might want to install 
one version for customers, and use a different version for 
development purposes. That way, you can make your own 
decisions about your mix of bleeding edge and final 
release software, important when trying to stay oil top of 
the latest technologies. 


Note that the "hard" work of developing the JavaBean by 
the programmer can be leveraged by dozens or thousands of 
visual builder users. 

What are Design Patterns? 

Design patterns are standardized w^ays of writing methods 
and interfaces. The simple example is of the property Too" which 
is set and retrieved with the functions a getFoo" and “setFoo.” 
Design patterns may be used to specify events, public methods, 
and properties. 

This is useful both for sell-documentation as well as 
automatic code generation. When a property is set in a builder 
tool, it generates the code based on these patterns. For example, 
if the user sets the value of Too" to "Bar then the builder would 
generate the code setFoo( Ll Bar rt ); automatically (or use 
Serialization, but that’s another topic). 

Alternatively, a developer may provide all of this information 
through a Tleanlnfo" function. Certain builder tools may be able 
to extract additional information through this mechanism, such as 
the icon to be drawn to represent a JavaBean or lex'alized versions 
of the properties and events. Developers interested in the 
development of serious JavaBeans should review the 
documentation available from JavaSoft, 

Note that successful design patterns require a few basic rules 
of thumb. First, different tools may wish to use the set and get 
methods in any order. Typically, this is not a problem — you can 
call something a "blue, translucent rectangle" or a “translucent, 
blue rectangle" without changing the results, but certain designs 
will imply changes. 

Design patterns exist for several standard concepts, including 
those listed fxdow: 

Simple properties are the basic “get" and ' set“ methods. To 
define a simple property, include methods of the form 

public SPropertyType) get<FropertyName>() 
public void set<PropertyNasne> £<PropertyType) x) 

For example, you could define your own Rectangle class, and 
include the following methods: 

public Color g&tColorO 
public void set€n lor{Color x) 

Note that the builder tool may recognize certain standard 
ProperlyNames and provide certain standard pickers. For example. 
Visual Cafe brings up the Apple Color Picker when a property has 
the Property Type Color 

A property may be formatted as public boolean 
is<PropertyName>{); format instead of a public <PropertyType> 
get<PropertyMam@>(); for better readability for English readers. 

Indexed properties are also supported with the standard 
formal of 

public <PropertyType> get<Prop®rtyHaraa>tint i) 
public void scKPruperi yNflme^Cinl 1, <Fropnrt. yTypn> x) 
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The New Event Model 

Events are also defined by Design Patterns. The model for 
handling events has changed significantly in the JDK 1.1 from the 
1.02 implementation. This is probably the area of your code which 
will require the most tweaking for general ports to JDK IT, 
regardless of whether or not you pay any attention to JavaBeans. 
While the JDK 1.1 supports the 1,02 event model, it does not 
support intermixing the IT and the 1,02 models. Before we can 
talk about events and JavaBeans, we have to briefly dive into the 
new JDK 1.1 events, 

JDK IT introduces a new event model based on the concept 
of listeners. The idea is simple — rather than poll for events 
repeatedly, your code registers itself as being interested in 
specific types of events, in other words* instead of asking every 
few seconds u whal happened," your code simply says Tell me 
when this happens,” This dramatically cuts down on the 
overhead for your code, especially in complex situations, For 
example, consider the mouse moved event — with a polling 
model (or any event model without a registration mechanism, 
such as the JDK 1.02 AWT')* this results in a fantastic number of 
events being generated {and much wasted processor time) — 
even if no one is listening! 

First, write the code which will handle the events. This class 
may implement one qfrhe following: 

ActionListenet 
AdjustmentListener 
CoraponentListener 
ContainerListener 
FocusListener 
Tt«»T. tat Finer 

KeyT.istP.rrer 

Ho uscLi steiter 
HoiiseHutionListeJiel: 

TextListener 
WindovListener 

These are interfaces and therefore you will have to actually 
implement a l! of the methods for die class. This can be tedious, 
hut you can optionally use one of the ‘'adaptor 11 classes which 
provide empty methods for all of the corresponding Listener’s 
methods. This allows you to use extends instead of implements, 
which may save you some code. You may have noticed that 
there are fewer adaptors than listeners some listeners, such 
as ActionListener, have a single method and an adaptor would 
serve no purpose: 

Comp on e ntAda p t e r 
CentalnerAdapter 
FocusAdapter 
KeyAdapter 
MouseAdapter 
Mon $gMo 11 otiAdap tc r 
WitidowAdapLet 


Your Listener or Adapter will receive an event when triggered, 
These events may he one of die following standard types: 

Act ioTiBvent 
Adj us taent Event 
ComponentEvent 
ContainerEvent 
FocuaEvent 
InputEvent 
ItemEvent 
KeyEvent 
MouscEvenL 
PiiintEvent 
TextEvent 
W indent Event 

The new event model appears more complex than it actually 
is. Those of you familiar with many of the frameworks or message- 
based event models will have a leg up on those who are used to 
the standard MacOS event loop, just remember, a Listener is the 
code that will he triggered by the event (the code that says T want 
keystrokes"), and an Even! object is a bit of stale referring to a 
specific occurrence of the event (a notification the user pressed 
‘a’). For our purposes, an adapter is a programmer's aid for 
implementing a Listener, 


Where's my 1DL? 

Those of you familiar with other mechanisms such as 
SOM may have noticed die lack of any sort of interface 
definition files. Simply writing public boolean i$Asl@ep(); is 
certainly a lot easier than writing SOM id) files, or trying to 
write COM interfaces by hand. Compiler vendors have made 
stabs at trying to solve the complexities of SOM and COM with 
varying degrees of success. Why is this? 

C++ libraries are statically compiled code — code which 
loses most of the type information as it is built. Everything is 
done as offsets from pointers, with no runtime enforced type 
checking. For example, any arbitrary pointer can be set and 
written to — there is no verification that the target of a write is 
an appropriate location. This is the source of a lot of crashes 
and memory corruption. 

In the original design of Java, all of the type data was kept 
around in the bytecode. This was originally done to make sure 
that if an inappropriate cast was made, die runtime would 
catch the error and throw an exception, C++ added a similar 
concept called RTF1 {runtime type identification) recently, but 
it doesn’t include a lot of die safety checking. As a side efleet, 
it rums out that all of this type information is very handy for 
parsing: the structure of a chunk of code, and made the design 
of JavaBeans a lot cleaner and more elegant than previous 
technologies, 

1 " << - r A ' r \ 'v 
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Making Your Own Events 

The JDK draws a distinction between low-lever events, 
such as a mouse down or a mouse moved, and a “semantic” 
event, such as an action event which is generated by a button 
press. It is possible for Java Beans to define their own semantic, 
higher level events. 

Create your own listener class by implementing an Eventlistener, 
;ind your new event types by implementing an l vent Object. Then use 
die following methods to register your interest in die events, and use die 
methods almve to handle the events: 

public void add<£ventListenerTyp!e>(<EveritLi^teneEType> a) 
public void remove<EventListenerType(<EvEntListenerType> a) 

U is worth spending some time to carefully plan how you w ill 
use these new events, and by adhering to design patterns such as 

void <eventQccurenceMethodName> 

E<Event.StateQbjfictType> evt); 

You can allow visual builder tools to take advantage of your 
new event type. An example of this would be 

public class ControlEyent extends java.util.EventObject [ 

// this event might have an additional method, 

// such as a gctValueO if it were a scrollbar 

i 

i nterface ControlLifStener extends java .Uti 1, EventListerner ( 
void controlFired(ControlEvert cn); 
void controlDeactivated(ControlEvent ce); 

// these arc the methods to lx: implemented 
// by code interested In the Control Event 
3 

Dive into the JDK 1.1 API level documentation for ihe new 
event APIs, As of lit is writing, youlf have to get your hands dirty 
by playing with the html documentation directly from JavaSoft. 


Final Notes 

All public methods may theoretically be exposed to the 
builder tool. Properties and events which make use of the 
guidelines above can typically take advantage of die standard 
tools available to the builder tool (such as standard popups for 
selecting boo leans in the Properties palette, automatically 
generated Font menus, color pickers, etc,). A suite of well 
designed components allows you to tie an awful lot of 
functionality together extremely rapidly; by creating your own 
you make it much easier for others to leverage your work. There 
was an awful lot of material of interest to Java beans developers 
we didn't cover here, including Serialization (persistent objects), 
RMI, and more. Despite the emphasis on visual builder tools, 
JavaBeans are completely usable directly from a “traditional” 
environment with handwritten source code. 

This article covered the initial concepts of JavaBeans, 
including the notions of properties and events, and it covered the 
structure behind how basic JavaBeans are built. Hopefully this Is 
enough for you to get started, and enough for you to understand 
a hit more about what’s going on “under the hood” with 
JavaBeans. Start off by playing around with Visual Cafe or another 
JavaBeans visual tool, and once you get a feel for how it works, try 
making your own java Bean by taking advantage of the design 
patterns and property definitions. Once you’ve gotten a feel for 
how this works, try playing around with the new event model, 
defining your own events and understanding how the firing chain 
of an event works. 

Good luck, and I hope JavaBeans helps make writing (and 
using) code that much easier. 


Help Make MacTech Work 


Here at MacTech Magazine, we rely heavily on 
outside writers for most of the material that 
appears in our pages. If readers did not 
participate in the magazine, sending us their 
ideas and taking the time to write articles, there 
would be no MacTech MacTech Magazine* is 
not a staff of writers sending a constant stream of 
one-way messages outwards; it s a living, 
evolving network of leaders conversing with 
one another, educating one another, sharing 
their knowledge, their experience, their interest, 
their trials and tribulations and joys and 
successes in the constantly unfolding story of 
programming the Macintosh. MacTech 
Magazine doesn't just happen it’s what tire 
community makes it. If wc carry reports of 
future trends and technologies, if wc teach 


useful methods, if we review new r books and 
1(x>ls, if we provoke thought, provide help, ride 
the wave of current interests and concerns, it is 
only because wc reflect the thoughts of our 
readers, who speak through our pages. 

You are invited to involve yourself in 
this exciting conversation amongst readers. 
No matter who you are, no matter whai your 
credentials may he, if you have a tale to tell, a 
trick to share, a technique Lu Leach, we wan I 
you lo consider joining the family of those 
who write for MacTech, 

Don’t just wait for a topic to lie covered 
or a technique explained in MacTech! Take 
responsibility! Write us an article yourself! 

To write for MacTech. just send for our 
Writer's Kit. It’s a Microsoft Word file 


containing the Styles you need to use, and 
giving lots of helpful advice and information, 
including all the legal stuff. You can let us 
know what you’re writing about, or, if you 
want to, you can just write the article and 
spring it on vis when it’s done. I Note: We also 
Save a need For people willing to make 
themselves available to write occasional 
product/book reviews*] if we publish your 
article, you’ll be paid for it! 

Write to us, the editorial staff, at 
editorial®madech.com (or one of the other 
addresses listed on page 2 of the magazine). 
Take the future of MacTech Magazine into 
your own hands! 


Maclbch 
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] City/SiaLc/Zlp_ . ___. { 
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] email____^ \ 

j Mail to: MHA Event Management, 1400 Providence Highway, 

J pa Box 9127. Norwood. MA 02062. Or Fax to: 61 7-440-03^7 

THIS IS NOT A REGISTRATION FORM. 
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• 

With so many products available to boost 
performance and creativity, your Mac has never 
had more potential than it does today. See the 
best and latest of these enhancements at 
MACWORLD Expo/Boston! 

The product offerings at retail stores arc no match 
for the breadth of choice you’ll find at MACWORLD 
Expo Catalogs may offer variety, but no opportunity 
to see demonstrations or ask questions. Only 
MACWORLD Expo lets you experience the full scope 
of Mac computing, with thousands of solutions for 

• Web site design and Internet navigation 

• publishing, entertainment and multimedia 

• networking, enterprise-wide connectivity, 
and intranets 

• education, R&D. research 

• business and telecommuting 

The Mac universe is 60 million users strong Rub 
shoulders with thousands of the most innovative, 
ingenious, and committed users at MACWORLD 
Expo. Network at special interest areas and pavilions 
that are free to all attendees. Learn from the experts, 
keep abreast of trends, maximize your Mac 

investment in more than 80 conference sessions. 
MACWORLD Expo opens your mind to new 
horizons accessible only through your Mac 


See us on the WWW at: 
http://www.mKa.com/ 
macworldexpo/ 
or call: 800-645-EXPO 


Please send more information on MACWORLD Expo 

□ Boston □ Sa n Fran cisco — —. 

□ Attending □ Exhibiting I 

Name __ _ . _ _ 

Title,_ 
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TIPS & 
TIDBITS 


by Steve Sisak 



Prettyprinting Complex Expressions 

The main problem with trying to read a complex expression in 
a program is trying to discern its structure. When you are writing 
such an expression, think of it as a tree, with the operators located 
where the branches join, and the operands attached to them. If you 
arrange your code to reflect something of this tree structure in two 
dimensions, the result becomes much easier to understand, 
let’s start with a simple example. Compare 

IF (NewState > OfState A .NrStsies) OR (NevState = 0) AND 
(OfState*.NrStates > 1) THEN 


with 

IF 

(NewState > OfSiate*.NrStates) 

OR 

(NevState * 0) AND (OfState A .NrStates > 1) 

THEN 


Note that the AND-expression and its subexpressions were 
not broken out onto separate lines, because they are simple 
enough that their clarity would not be helped by this. 

See how gracefully this technique copes with increasing 
numbers of subexpressions: 

RETURN 

(TheFoint.x TheRect.left) 

AND 

(TheFoint.x < TheRect.right) 

AND 

(ThePoint.y >- TheRect,top) 

AND 

(ThePoiiiuy < TheRect-bottom) 


Imagine what a mess this would look like all run together: 
IE 

NOT EqualFixedRert 
( 

OldEniry*.Devicelntersect, 

NewEniry.Uevic «Intersect 

OR 

NOT BIockEqual 

C 

CSrtl :=■*) ADR(OldEnrry A .DevireMspping) * 
f SfC2 r=*) ADR ( NowFnt. ry * Dev i ceMa pp t ng), 

(*Coum :=*) SIZE(gxMapjjlng) 

) 

OR 

{ 

OidEntry* .DeviceBitmap .width 

<> 

MewEntry.Devi ceMtmap.width 

) 


OK 

( 

OldEntry A . Devicelitmao . height 

<> 

NewEntry,DeviceBitmap.height 

) 

OR 

NOT EqiialColorSet 
{ 

01dEntry A ,DeviceBittoap.set* 
NevEntry.DeviceBitmup.set 

) 

OR 

NOT EqualColorProfile 
£ 

OldEntry*.DevicreBitmap.profile, 
NewEm ry.Devieefiiimap.profile 

THEN 


or tills one: 

IE 

( 

TliisDevlce AA .gdPHap AJ ' .pixelSIse 
OtherDevice* A .gdFMap A A ,plxelSize 

) 

AND 

£ 

(QuickDraw.gdDevType IN Thi sDevite AA . gdFlags) 
(QuickDraw,gdDvvTypc IN Ot he rDeviro iV '\gd Flags) 

) 

AND 

£ 

( 

Qui ckD raw. dotitMatchSeed a 
IN 

flags 

) 

OR 

{ 

ThifiDevice AA .gdPMap AA .pmTabie AA -ctSeed 
OtherDevice AA , gdPMap AA . ptnTable AA . ctSeed 

) 

) 

THEN 

Such an arrangement also makes it easier to attach comments 
explaining what the subexpressions are for: 

u? 

{Windows.FtoniWindowU = NiL) 

C no other windows active *) 

AND 

(LastFalette0 O Windows.WindowInFront) 

C I haw palettes *) 

THEN 


By the way, these are not made-up examples, they are all 
from actual working code. This isn't about exercises for kiddies in 
classrooms, it's about real-world programming! 

Lawrence D'Qlimira 
<LDO®tmikato.ac * nz> 
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If you want to be in the know, then you 
need every article published in the first 
12 years of MacTech Magazine and 
Apple’s develop' 1 issues 1 - 29 ! 

... in THINK Reference format1 


So hurry, pick up the phone, fire up 
the e-mail, launch that fax machine, 
or simply drop by our web site and 
order yourself this new release of 
the MacTech CD-ROM. 

• Almost 1600 articles from all 139 issues of 
MacTech Magazine (1984-1996) 

• Includes Apple develop issues 1-29 

• Improved hypertext, improved indices, and a new THINK W ^ 

Reference Viewer — for lightning quick access! ' 

• New hyperlinks between articles 

• 100+ MB of source code — use them in your applications, with no royalties! 

• Full version of THINK Reference — the original online guide to Inside 
Macintosh ,Vols. I-VI 

• BOMB of FrameWorks/SFA archives and the most complete set of Frameworks 
archives known 



Sprocket™! MacTech's tiny framework that compiles quickly and supports 
System 7.5 features 

The best threads from the Mac programmer newsgroups plus thousands 
of notes, tips, snippets, and gotchas 


• Popular tools that Mac programmers use to increase their productivity and 
much more! 



Web Site: http//www.devdepot.com • E-mail: orders@devdepot.com 

Phone: 800-MACDEV-l • Outside the U.S. & Canada: 805-494-9797 • Fax: 805494-9798 


MacTech is a registered trademark of Xplain Corporation. Mac Dev-1, THINK Reference, Developer Depot, Sprocket, JavaTech, WebTech, BeTech, and the MacTutorMan 
are trademarks of Xplain Corporation, Other trademarks and copyrights appearing In this printing or software remain the property of Iheir respective holders. 








MACTECH 

ONLINE 


by Nicholas C. “nick.c" DeMello, <USLs@mactech.com> 



Making Things Happen — Online 


The web has come to life. Every page you bounce off of 
these days has a popup menu for navigation, a Licking clock, or 
an animated banner It's exciting, it's stimulating, hey — it T s fun. 
Well., at least it is until your client asks why those same bells 
and whistles aren't chiming on his page. If you’re trying to make 
things happen on a web site, TVe got some gtx>d news for you. 
You don’t have lo create all those spectacular effects — most of 
the time, you just need to know where to download them, 

JavaScript — Automating HTML 

When folks decided it was time to liven up the web, they 
determined that there were at least two wavs to go aboui doing ii. 
The first strategy was just lo figure out how to control the web ele¬ 
ments we were already familiar with. How do we script the behav¬ 
ior of images, windows, tables, text, links, and panes? Based on 
Sun’s Java language the JavaScript command language was devel¬ 
oped by Netscape Communications. JavaScript was originally 
codenamed Mocha, and then LiveScript. A brief overview of it's 
history and origins has been put on the nei by Frank Hccker. 

JavaScript is written directly into your HTML code between 
<SCRIFT>. ,</SCRIPT> tags, and is interpreted by your browser at 
runtime. The language Ls extremely easy to learn, especially with 
The aid of online resources like the JavaScript 411 pages, Java Script 
411 maintains a JavaScript FAQ as well as a tutorial, Another useful 
tutorial is Stefan Koch's "Voodoo'’ introduction to JavaScript, which 
will take you from “Hello World" to dynamically building new 
pages for your user. But the real wealth in online resources are the 
example code and libraries of reusable JavaScript functions, like the 
JavaScript Planet website and Netscape* JavaScript Guide. Also, be 
sure Lo check out Nick Heinle's JavaScript Tip of the week. 

Frank Hetker's History of JavaScript 

chttp:// w ww. access digex. net / - h ec ker/netscape/maj ug/ja vascri pt/> 

JavaScript 411—the complete source for JavaScript information 

<hnp://www, f reqg ral x .com M 11 /> 

Voodoo's Introduction To JavaScript 

<http Jfwmt.mbcom com/java/javasolpt/i ntro/tutorial. htm> 

The JavaScript Mailing List 

<http://www. N ETural. com/j avascr ipt/> 

The JavaScript Planet 

<hnp://www.geocities.com/Silicon Valley//1 t£V> 

The Netscape JavaScript Guide 

< http://home, netsca pe com/ten g/moril I a/3 O/handbook/javascri pt/in dex. htm i > 

The JavaScript Tip of the Week 

< hi tp://www, web rp lerenc p. com/javastri pt/> 


Java Applets — Beyond HTML 

Sometimes, JavaScript isn’t enough. Applets — compiled 
binaries of Java code — offer an extension of HTML. Applets 
can be embedded into HTML documents the same way a gif or 
jpeg can. The Java virtual machine incorporated into Internet 
Explorer and versions of Netscape Navigator 2.0 or greater 
interprets and executes the logic in the applets. Unlike 
JavaScript, which is limited to manipulating HTML elements, 
Java is a complete modern language and limited only by your 
imagination. I’ll touch on online references related to creating 
applets in a future column, lets talk today about the component 
relationship of applets in HTML, Let s talk about using applets. 
Compiled applets for implementing a cluck, blinking text, 
scrolling images, and sounding audio files exist at the Cafe del 
Sol. The online Cafe gives you a complete description of what 
parameters to pass to them and how ro add these applets to 
vour web pages, bui if you need a little more info Sun has put 
a complete description of how to insert applets into HTML 
Other places to download component applets include die 
JavaSoft applet archive and the hot applet picks of die month at 
the Gamelin site. Make sure you explore the rest of Gamelin 
when you visit that site, Gamelin is a tremendous resource of 
applets and other Java information. 

Sun s Description of Java Applets 

<http://www.ja vasoft com; BO /a pp1ets/> 

New Media's Java Applet Collection—the Cafe del Sol 

<http://www.xm. com/caf e/app tetv htm!> 

"How to Create an Applet Tag" by Sun 

<http://java. 5 vn.eom/products/jdk/ 1 .1 /docs/guide/mi sc/app I ct.htm I > 

Applets from JavaSoft 

<h t tp://ww w. j avasofi. com: 80 /a pplets/ js - a pp I et s. h t ml > 

Gamelin's Hot Picks of the Month Applet Collection 

< http://www. ga me tan .com/special/picks, html > 

Parting Shot's 

In two months MacTedi Online is going to gel serious about 
Java. Below are some Java online resources to explore between 
now then. Well leave you with some links to important compo¬ 
nent technologies, 14ie.se and oilier links are accessible at the 
MacTedi URL database 1 <http://wvwv.mactech,com/magazine/urls/>. 
See you next month. B 
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(...and we really mean now.) 


Think of it as your source of news and announcements in the MacOS 
developer community. Loaded with up to the latest news, and con¬ 
stantly updated with developments in our industry. 

MacTech* NOW brings you up to speed on everything you need to 
know' — instanLly! And thanks to our new “fast-download” design, 
you’ll get to the information you want in seconds. 

Give it a spin! Check it out today and get access to over 1500 pages 
loaded with news, tips, programming secrets, product reviews, and 
much more. And for those of you looking for some kicks, there’s the 
ever popular “Programmer’s Challenge” section where you'll get to 
bang heads with the best in the community. 

Log on to MacTech NOW, Things arc happening right now, and you 
should be aware of them. 



MacTech is a registered trademark of Xplain Corporation. MacDev-1, THINK Reference, Developer Depot, Sprocket, 
JavaTech, WebTech, BeTech, and the MacTutorMan are trademarks of Xplain Corporation, Other trademarks and copy¬ 
rights appearing in this printing or software remain the property of their respective holders. 





by Jessica Courtney 


Apple MessagePad 2000 Sales Booming Less Than A 
Month After Product Ships 

The Apple Newton MessagePad 2000 is roaring oui of die 
gate, Apple Computer, Inc, reports that less than a month after its 
March 24 ship date, the newest member of its Newton family of 
mobile business appliances Is selling briskly at both the corporate 
and retail levels* 

Announced last October, the MessagePad 2000 offers 
features that are important for mobile professionals, including 
e-mail, fax, and Internet access capability (modem and Internet 
service provider account must be purchased separately), as 
well as personal productivity software at a fraction of a laptop's 
weight: 1.4 pounds. Built around the 160 MHz StrongARM 
processor, the MessagePad 2000 performs up to ten times faster 
than current handheld computers in the market today and 
works easily to exchange data with hoih Windows and MacOS- 
based computers. 

The MessagePad 2000 and its Newton Operating System 
Software can lie an important productivity tool for users of 
desktop systems that run either platform. 

The MessagePad 2000 incorporates a new version of the 
Newton operating system enabling it to support additional 
functionality such as voice recording and a 16-levcl gray scale 
screen* The computer comes preconfigured with a web 
browser and e-mail client software (modem and Internet 
Service Provider required for Internet access), a word 
processor, spreadsheet (available in most configurations), and 
Newton address book, calendar, and notes applications. The 
computer can exchange data with many major Windows and 
Macintosh personal information management applications, 
including Microsoft Schedule* 7*0, Lotus Organizer 2.1, and 
Claris Organizer 2*0 using Apple’s Newton Connection Utilities 
(included)* The computer's Auto Dock feature makes these 
data transfers easy* The MessagePad 2000 can also transfer 
data to and from Microsoft Excel or Word on both Windows 
and MacGS-based systems. 

Weeks of Run-time on a Single Charge Four A A alkaline 
batteries or a rechargeable battery pack with one-hour 
recharge will power the device for up to six weeks of normal 
usage. The computer has two Type II PC Card slots that 
support many wired and wireless communication solutions 
already shipping for the Newton operating system, as well as 
expansion for applications and memory cards. An instant on 
feature lets you quickly begin working — there is no waiting 
for the device to bootup. The MessagePad 2000 comes 
standard with 5MB MM and 8MB of ROM T Cirrus Voyager chip 
set, and a power efficient, backlit screen with 16-level gray 


scale. The entire width of a fax or web page can be scaled to be 
viewed and the screen can rotate 360 degrees which means that 
users can view and work on the screen, either horizontally, 
vertically or upside down, depending on their preference* A 
built-in microphone and speaker enables users to record and 
play back voice dictation* Options include a lightweight, touch- 
type keyboard (available as standard in some configurations), 
NiMh rechargeable battery pack, AC adapter, and additional 
flash memory cards. Built in software enables direct printing to 
serial, IrDA and LocaiTalk printers. The optional Print Pack 
allows printing to parallel printers. 

The MessagePad 2000 retails for approximately U.S. $950 to 
LIS* $1,100, depending on configuration. 

Purity Software Offers WebSiphon 

Purity Software announces a competitive upgrade 
program that can save users $150 when purchasing 
WebSiphon, the powerful server-side web application 
development tool for Macintosh web sites The offer enables 
users of any retail version of NetCIoak or NetForms to 
purchase a full retail copy of WebSiphon v 1*0*2 at a special 
promotional price of $345 and is available until June 30th t 
1997. Users who purchase WebSiphon under this program will 
receive a free upgrade to WebSiphon vl*5 when it ships laLer 
this year. 

The competitive upgrade program was developed in 
response to requests by NetCIoak and NetForms users who feel 
restricted by the limited fcalurc-*scl available in current versions 
of these products, 

WebSiphon allows you to rapidly design custom server- 
side web applications by embedding an easy to learn 
scripting language directly into your HTML documents. 
WebSiphon aho includes Verona, the only Macintosh flat-file 
database server written specifically for use on a web site. 
Unlike other authoring solutions currently available, 
WebSiphoiTs scripting language is actually a compiled 
language designed from day one to produce outstanding 
performance on a Macintosh web server. The language offers 
extensive support for variables, conditional statements, 
powerful looping, and built-in functions. Function libraries 
included with WebSiphon are quite powerful, with over 80 
functions available, and provide web-related services such as 
client redirection and authorization, string manipulation, date 
and time, text file support, full math support, and more* In 
addition, the upcoming WebSiphon vl.5 upgrade will 
increase the power available incredibly. 
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WebSiphon requires a Macintosh computer running System 
7,5 or higher, 1 MB RAM for WebSiphon, and a Macintosh web 
server 

A demonstration copy of WebSiphon is available from Purity 
Software’s web site ul <http://www.purityxom/websiphon/>. 

Astkobyte Announces New Web Authoring XTension 

Astrobyle announces BeyondPress 3 0, the latest version 
of its web authoring XTension for QuarkXPress, The 3,0 
version supports both Windows and MaeOS t includes all the 
document-conversion features of its predecessor, and adds 
powerful Web page authoring and management tools, 

WYSIWYG Web Authoring 

BeyondPress 3-0 lets designers create web pages using 
advanced text formatting and page layout tools. Using the 
Cascading Style Sheet support of Microsoft InterneL Explorer 
3.0 and the upcoming Netscape Navigator 4.0, plus 
Bitstream's True Doc font technology, BeyondPress converts 
stylized text in a QuarkXPress document to formatted text on 
a web page, retaining the intended fonts and type size. 
BeyondPress uses HTML tables to approximate the layout of a 
QuarkXPress page. 

BeyondPress 3 0 helps designers place text, images, and 
multimedia/interactive elements on web pages by letting them 
drag these elements into a page. QuickTime, Java, RealAudio, 
animated GIFs, and Shockwave files can be imported into web 
pages just as images and text are brought into QuarkXPress 
pages. Java applet preview capabilities, live play of animated 
GIFs and QuickTime movies, and image-editing features add 
to BeyondPress’ utilities. BeyondPress also supports Live 
Picture's FlashPix format, in conjunction with the Live Picture 
XTension. 

BeyondPress 3,0 builds on the authoring environment of 
QuarkXPress. Web designers benefit from QuarkXPress’ 
advanced find/change, spell checking, box borders, rotation, 
polygonal shapes, and master page features when creating web 
pages. BeyondPress adds fuli drag-and-drop capabilities, letting 
designers move images, text, or en Li re pages from QuarkXPress 
to an HTML editor or to the Finder, retaining text formats, 
image quality, and the approximate layout of the page. 

Document Conversion 

As in previous versions, BeyondPress 3-0 will convert 
existing QuarkXPress documents to web pages, without 
changing their Formatting. Images ean be cropped, scaled, and 
converted to JPEG and GIF formats. Modified color palettes 
can be created for individual images, or a specific color 
palette can be applied to all images. BeyondPress can convert 
all images on a page to the Netscape 216 color palette (the 
colors that most browsers display best on both Windows and 
MacOS). Hypertext links, background colors and images, and 
complex image maps are easily created with Bey ondPress. 


Single-user copies will be $495 worldwide until June 30; S595 
thereafter. BeyondPress 2.0 users can upgrade for $149 until June 
30; $179 thereafter. BeyondPress 1.0 users can upgrade for $249 
until June 30; $299 thereafter. Cyberpress users can upgrade for 
$349 until June 30; $449 thereafter 

BeyondPress 3-0 is available directly from Astrobyre, from its 
Web site <http://www.astrobyte.com>. 

Motorola Bundles DAVE with StarMax Systems 

Thursby Software Systems, Inc. (TSS), developer of 
MacOS cross-platform solutions, announced a bundling 
agreement with Motorola Computer Group (MCG) that 
includes DAVE software to be shipped with StarMax systems 
beginning in mid-May. 

DAVE V 1,0,1 is the latest release from Thursby Software. It is 
a very fast, new r version of iLs powerful MacOS to Windows 
networks connectivity software* 

Motorola has strategically included DAVE for cross-platform 
connectivity with new StarMax configurations focused on the 
“enterprise* market, 

DAVE is the only software solution that enables StarMax 
users to share files and printers with Windows NT (Server and 
Workstation), Windows 95 and Windows for Workgroups 
computers using TCP/IP, DAVE makes the StarMax fit into 
Microsoft networks as if it were a PC. 

Tills solution is unique because DAVE uses the open, 
industry standard protocol TCP/IP for file sharing, not 
AppleTalk. It is installed on the familiar MacOS system and not 
the PC. No additional hardware or software is required; it 
simply utilizes the current network infrastructure. DAVE makes 
the MacOS system totally compatible and interoperable with 
Wintel networks, supporting Internet and corporate intranet 
access, while requiring little intervention from PC 
administrators. 

DAVE is designed with ease-of-use in mind and is as 
AppleShare-like as possible. Users select DAVE from die Chooser 
and then easily mount PC user's shared directories, DAVE is a full 
featured product, integrating with NT Services for Macintosh and 
supporting multiple mounts. It offers a secure environment 
through encrypted passwords and supports both the 68K and 
PPC Macintosh, 

DAVE retails for Si79 00 and is available worldwide. 
Information regarding Thursby Software products can be found 
at <http://www.thursby.com> HO 


Want to suggest an article for the 
magazine? Send your suggestion to 
<mailto:editorial@mactech.com> 
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The Future of Publishing 
Software is Mow in Seattle 


nth degree software is a leader 
in high performance desktop publishing 
solutions, and developer of PROTEUS, 
Publishing magazine's 1996 "Product of the 
Year." We offer award-winning object-ori¬ 
ented print production applications to 
Fortune 500 companies, leading newspa¬ 
pers, magazines, and other high-end pub¬ 
lishers. Our spectacular growth has result¬ 
ed in our relocation to Bellevue and immedi¬ 
ate openings in the following areas (rele¬ 
vant DTP experience is a plus for all posi¬ 
tions): 

Senior Design Engineers 

Requires 3-5 years of hands-on experi¬ 
ence in planning, prototyping and building 
client-server or DTP applications, with 
emphasis on process and data modeling 
using 00 techniques. Experience should 
include at least two of the following: Java; 
C++; Smalltalk; Visual C++; CodeWarrior; 
any 00, object-relational, and/or high-end 
relational (SQL) database engines. 

Applications Engineers 

Requires a CS degree and at least 2 
years of hands-on experience developing 
commercial applications using C++, 
Smalltalk, Java. Experience with 00, 
object-relational, and/or relational database 
engines is a plus. 

Entry-Level Applications Engineers 

Requires a CS degree and practical 
knowledge of C++, Smalltalk, Java, and/or 
object-oriented, object-relational, or rela¬ 
tional database internals. 

QA Managing Engineer 

Requires demonstrated experience in 


designing test strategies, performing test 
planning and managing test teams. 
Programming experience is a plus. 

QA Engineers 

Requires demonstrated experience in 
diagnostic analysis, regression testing and 
automated test scripting, as well as hands- 
on experience with testing tools and test 
bed development. 

Systems Administrator/Webmaster 

Requires at least 2 years of experience 
specifying and troubleshooting Apple, 
Windows (95 & NT), and Novell networks, 
with multiple remote sites. Scripting experi¬ 
ence is a plus, especially HTML, Java, 
Director, and/or AppleScript. 

Technical Support Representatives 

Requires strong communication skills, 
and experience with defect diagnosis and 
workaround conceptualization for unimple¬ 
mented functionality. Requires in-depth 
familiarity with Mac and Windows OS. 
Experience in digital pre-press, support or 
training is a plus. 

nth degree provides a team-oriented 
environment, in which self-motivation, cre¬ 
ativity, and technical excellence are highly 
valued and rewarded. We offer many 
opportunities for growth, starting with an 
exceptional compensation package (with a 
long list of benefits, including an Employee 
Stock Options Program). 

Send your resume by e-mail to 
jobs@nthzone.com, or fax to (702) 588-4901. 
To learn more, please visit our home page 
at http://www.nthzone.com. 


nth degree software 
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The Law Office of Bradley M. Sniderman 

California Lawyer focusing on Intellectual 
Property, Corporate, Commercial and Contract 
law, as well as Wills and Trusts. 

If you are looking to protect your software with 
Copyright or Trademark protection, or if you need 
help establishing or maintaining your business, 
please give me a call or an e-mail. Reasonable fees. 

( 310 ) 553-4054 
Brad@Sniderman.com 


MacTech Magazine is your 
recruitment vehicle 

When you need to fill important positions at your 
company, MacTech Magazine is the consistent choice of 
companies across the country for hiring the best qualified 
Macintosh programmers and developers. Let MacTech 
Magazine deliver your rccruit-ment message to an audience 
of over 27,000 qualified computer professionals. 

Call Ruth Snbrin at 805/494-9797 



Professional software developers 

looking for career opportunities 
should check out our web site. We 
offer nationwide employment assis¬ 
tance, resume help, marketability 
assessment, and never a fee to the 
applicant. 800-231-5920, Fax 800- 
757-9003 eMail :das @scienti lic.com 

Scientific 
Placement, Inc. 

V___: ... 




Depot 


move? 


i 


The fastest, cost effective way to get product off your shelves. 

For information: * Voice: 805/494 -9797 • Fax: 805/494-9798 * E-mail: vendor_reIations@devdepot.com 


June 1997 • MacTech 


Classifieds 


81 



























ADVERTISER/ 
PRODUCT LIST 


LIST OF ADVERTISERS 


LIST OF PRODUCTS 


Aladdin Knowledge Systems lid ...5 


Aladdin Systems, Inc..16-17 

Bane Bones Software, Inc..1 

BecHivc Technologies, Inc..13 

Bowers Development..28 

Crawford Software Consortium ....45 

Datapak Software Inc..7 

DC Micro Development.30 

Developer Depot..103 

dtF Americas, Inc...31 

Faircom Corporation.21 

FlexWare International LLC..32 

Macworld FXPO..73 

MacTech" CD ROM..75 

MacTcch Now!..77 

Mango Tree Software, Inc..27 

Malhemaesthetics, Inc..15 

Metrowerks. ,.BC 

Micro Macro Tecluiologies, lid..9 

Miracle Software, Inc... 33 

Neokigjc Systems..25 

Nth Degree..80 

Onyx Technology....23 

PACE Anti-Piracy.29 

Perforce Software.... 37 

Primellme Freeware.34 

Purity Software. IBC 

Quasar Knowledge Systems.50 

Ray Sauers Associates.53 

Scientific Placement.81 

Seapine Software, Inc..19 

SniartCode Software, Inc..11 

Stone Tablet Publishing..39 

Symantec.. IFC 

Water’s Edge Software.18 

WEBster Computing Services.51 


ADBI/O • Beehive Technologies, Inc.13 

AppMaker • Bowers Development ..28 

BBEdit • Bare Bones Software, Inc.1 

Code Warrior™ • Metrowerks ....BC 

Crusher! 7 '* DC Micro Development.30 

c-trcc™ • Faircom Corporation. 21 

Developer Tools • Developer Depot .103 

Draglnstall * Ray Sauers Associates ...53 

dtF, The Relational Database System • dtF Americas, Inc....31 

FairCom® Server • Purity Software .IBC 

FlexWare' • FlexWare International LLC.32 

InstallerMaker • Aladdin Systems, Ine.16-17 

MacIIASP • Aladdin Knowledge Systems Ltd.5 

MacRegistry ‘ • Scientific Placement.81 

MicroGuard Plus " • Micro Macro Technologies, Ltd.9 

MK Linux •PrimeTime Freeware...34 

neoAcccss™ • Neologic Systems .25 

ObjectSct Mail SDK • SmartCode Software, Inc.11 

ODBC Driver • Faircom Corporation.21 

OpenPaigc "• DataPak Software, Inc.7 

PACE Software Authorization System • PACE Anti-Piracy.29 

Perforce • Perforce Software ....37 

Recruitment • Nth Degree. 80 

Recruitment • Scientific Placement.81 

Resorcerer 1.2 • Malhemaesthetics, Inc.15 

r-tree" • Faircom Corporation........21 

SiteWeaver* Miracle Software, Inc. 33 

SmallTalk Agents’ • Quasar Knowledge Systems.50 

Spotlight" • Onyx Technology...23 

Stone Table " • Stone Tablet Publishing...39 

Stufflt Installer Maker 3-1 • Aladdin Systems..16-17 

TestTrack" • Seapine Software, Inc...19 

TCP/IP Scripting Addition • Mango Tree Software.27 

Tools Plus " • Water’s Edge Software.18 

Trade Show* Macworld Expo.73 

Visual Cafe" for Java* Symantec ...IFC 

WcbScntincr • Purity Software. IBC 

WcbSiphon * Purity Software. IBC 

WEBsitc Hosting Services • WEBster Computing Services..51 

Word Services Suite • Crawford Software Consortium...45 


The index on ihis page is provided as a service u> our reader. The publisher does not assume any liability for errors or omissions 


82 


ADVERTISER/PfiODUCl 1 LIST 


MacTech * June, 1997 





















































































by Mike Halpin and Etizabctb Dykstra-Erickson 


Supporting Links in Your OpenDoc Part 


OpenDoc linking enables users to 
maintain synchronized copies of content at 
multifile locations, so that they can reuse 
content without having to manually update 
each time a change is made to the master 
copy , You may he wondering whether it's 
time to support linking in your part editor 
this article will help you assess the difficulty 
and desirability of doing so — and includes 
useful code samples to get you off to a qu ick 
start in addition, it discusses linking- 
related requirements that apply to all parts , 

Suppose a user is creating a 
presentation from numeric data in a 
spreadsheet and wanes to display the same 
data in a variety of ways. If both the 
spreadsheet part editor and the 
presentation part editor support linking, 
the user can link the data and create 
simple to sophisticated visualizations of 
Lhe data without reentering it. in addition, 
if the data is live (for example, if it's being 
generated by a stock ticker), real-time data 
changes can be displayed dynamically in 
multiple ways throughout the presentation. 


Here’s ant Alter scenario; The user is preparing a very' large 
document that's shared by multiple users. If die pan editors 
employed in the document support linking, all users can fink 
con Lent for which they’re responsible from one portion of the 
document to another, keeping iL synchronized at their discretion* 
Text, numeric data, and graphic elements can be linked to facilitate 
easy, immediate updates to complex documents. 

Or maylx: a user is creating a schematic that uses the same 
set of symbols in many locations. If the schematic part supports 
linking, the user need only create each symbol once, place it in 
a library, and link it to each destination location* That way, if a 
symbol needs to be changed, die user need only modify the 
source and update the links to refresh each instance of the 
symlxd. This could be useful for symbols, shapes, or labels used 
on blueprints, engineering diagrams, flowcharts, organization 
charts, calendars — you name it. 

These examples should give you an inkling of die kind of 
power you put in users' hands when you support linking in your 
OpenDoc part. Although the user needs to plan ahead and spend 
the time to create the links, the link interface is easy to use and 
can save a tot of time and effort for data that’s expected to 
change frequently but must be kept in syne. Linking is 
comparable to but much easier to implement and use than die 
"publish and subscribe'’ feature introduced in System 7. 

This article will help you think realistically about what it 
would take to implement Unking support in your part editor* The 


Mike Halpin (jaiapeno@softharrnony*CQm) is die principal and chief engineer in the consulting firm of Harmony Engineering, Inc., 
in Soqud, CA. A software engineer for more than 10 years, he’s spent the last two in OpenDoc quality and engineering efforts 
at Apple, most recently improving support for data transfer and embedding in ODE A veteran of 12 years on The Farm, an 
agrarian commune in Tennessee, Mike worked as a plumber, an electrician, a machinist, and a refrigeration mechanic before 
going on to obtain a U S, in math in preparation for his present career. He spends his spare time playing the flute and enjoys 
cooking for family and friends. 

Hli/xilyeth Dy ksLra-Erickso n (eade@apple*Com} was the lead human interface designer for OpenDoc, and was with the project 
for nearly three years. She is a Senior Interaction Designer in Apple’s Human Interface Design Center and currently works on 
conceptual design for network and server products, t ter expertise is in collaborative software design and design methods. She 
lives in San Francisco with her husband and two children. Elizabeth also teaches human factors, web design, and multimedia 
classes at the University of San Francisco and is pursuing a doctorate in educational technology (leaving just enough time to 
thoroughly enjoy her newest project, Baby Gunnar, but not enough time to play the piano,, oh well). 
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Tent Document 


My text document has a chart embedded 
in it The source data for the chart comes 
from the table, md the two are linked, 
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Editor: | SurfWriter 1.5 ▼ | 
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Figure 2 . The Paste As dialog box. 


Figure /, Linked data. 

OpenDoc API aspects of linking can be pretty easily encapsulated 
in reusable code, either inherited from a framework such as the 
OpenDtx: Development Framework (QDF) or lifted from the 
LinkingPart sample accompanying this article. The most 
challenging aspects of linking design revolve around eontenf- 
spedfic issues* After giving an overview of the linking process, 
well focus on sortie particular Issues that our experience indicates 
may not lx 1 obvious from the existing documentation. Even if 
you’ve already decided that your part editor isn't going to suppon 
linking, you should read the section entitled “Linking-Related 
Requirements for All Parts,” Ixxmsc tilts still applies to you. 

To Ixmefit from reading this article, you should have at least 
a passing familiarity with a number of basic OpenDoc concepts. If 
you don't know what storage unit, [xtrsisient object, cloning, 
externalize, and internalize mean, we recommend the article 
"Getting Started With OpenDoc Storage” in develop Issue 24, This 
article is Intended to augment information that's already available 
in the OpenDoc Programmer's Guide , in the OpenDoc Cookbook, 
and in the recipes provided with each OpenDoc Developer 
Release. In addition, updates are periodically posted on Apple's 
OpenDoc Weh site at <http://www.opendoc.apple.com>. 

The code examples in this article are adapted from 
LinkingPart, a container part that allows the arbitrary placement 
and resizing of any number of embedded frames within a layout 
grid. Selections are arbitrary collections of embedded frames, 
which can he cut, copied, pasted, dragged, dropped, and linked. 
Mast of the code examples in the article have been simplified to 
illustrate specific points, so if you're going to adapt code from 
LinkingPart, you should take it from the actual sources, not from 
the excerpts in this article. 


What’s a Llnk, and How is rr Created? 

A link Ls a one-way path for the How- of data from a link 
source to a link destination. Links ran lx. 1 created within a single 
part, IxMween two parts in the same document, or between pans 
in different documents. Figure t shows an example of data linked 
from a table pari to a chart pari in a document. 

To create a link, the user selects some content, copies it to 
tile Clipboard, and then chooses the Paste As command from the 
Eklit menu. Alternatively, the user can drag content from one 
location to another while holding down the Command key. In 
response Lo either action, your part editor should present the 
Paste As dialog ix>x, shown in Figure 2. If Ixith the source of the 
Copy or drag and the destination of the Paste As or drop support 
linking, the "Paste with Link" chccklxix will be enabled. If the 
user checks this option, site can then specify either automatic or 
manual updating with the Get Updates radio buttons. The result 
will lx* that the pasted or dropped content will become a link 
destination and will Ik* updated to reflect changes made at the 
source of the link. 

The main work of linking consists of transmitting data 
between link sources and destinations. Some of this work is 
implemented by OpenDoc and some must be implemented by the 
pait editor or editors involved. Later nn well discuss the work in 
each category in more derail. 

In addition to supporting the transfer of data from sources 
Lo destinations, OpenDoc provides a number of auxiliary 
mechanisms to support the user interface for treating and 
maintaining links. These include a notification mechanism so 
that parts maintaining destinations know when to acquire 
updated content; a navigation mechanism that enables users to 
locate link sources from any destination, even when die source 
is in a closed document; and a mechanism that protects against 
runaway recursive updates. 
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You can choose to support source links or destination links, 
or both (or neither). In general, viewers don't need to support link 
sources (although we think it would be nice for them to support 
link destinations!). Linking makes more sense in some part editors 
than in others. You'll need to use your own judgment to determine 
how often the user may want to create source links in your 
particular part editor, and balance that against the effort required 
Of you to implement it, For example, supporting links in a chart or 
table pan editor will lx: well worth the effort, while doing so in a 
button or sound part editor might not be, 

LtNKINCrRElATED REQUIREMENTS FOR ALL PARTS 

Your part must comply with certain linking-related requirements 
whether it supports linking or not, because tt might be embedded in a 
link source or destination. Your part must make linking-related culls 
whenever the user attempts to edit your pan content, when your part's 
content changes, when the content of an embedded part changes, or 
when a frame is newly embedded in your part. DDK takes tare of 
mast of tills for you, though you may need lo override some methods 
to customize the I ndiavtor to your content. 

When the User Attempts to Edit your Pari Content 

Because your part might be embedded in a link destination, 
your editor needs to check the link status of the part's display frame 
before allow ing the user to make any change to the part content. The 
frame s link status, set fur embedded frames by the containing part, 
indicates whether the frame us in the source of a link, in die 
destination of a link, or not involved in any link, Because GpenDoc 
links art: a one-way path from source to destination, content changes 
shouldn’t lx? allowed in a link destination. 

When die user attempts to modify your part's content, your editor 
must call 01 )Frame;?Ge£l JnkSiarus to determine die link status of your 
[Kin's display frame, ft die call returns kODlnlinkDesrination, your 
editor should call ODFramet: EditlnLink. ibis will anise Open Doc to 
contact the part that maintains the link destination including your 
display frame, so licit diat part can display an alert telling the user that 
content at a link destination cant lx? edited, This alert would give the 
user the opportunity to either find the source and edit it or break the 
link (as shown later in Figure 7). 

If EditlnLink returns false, meaning that the part containing the 
link couldn't be found (unlikely, bur it could happen in the ease of a 
containing part problem), your part should [X\st an alert telling the 
user it isn't possible to edit this link destination. If EditlnLink returns 
true, your part should call GetLinkStatus one more time to determine 
whether the link destination in which your part Is embedded lues 
now been broken by the user If GetLinkStatus returns any result 
other than kOLMnLink Destination, your part should allow the action 
initiated by the user to complete. If GetLinkStatus returns 
kODfnLinkDesiination again, you should abort that action, leaving 
your content unchanged. 

The method TryToEdiL shown in Listing l t can lx? called 
whenever the user has attempted Lo modify content. It integrates 
GetLinkStatus and EditlnLink into a single methtxl whose Boolean 
result indicates whether the attempted action should be 
completed (kODTrue) or aborted (kODFalse). 


Listing 1. Determining whether a change should ix> permitted 

ODBoolean Linkin^Part::TryToEdit(Environment * ev, 
ODFrame* Frama) 

l 

OUBoslean eattSdlt _ l = 

kGDl nLi tikrten ti n at ion; 

if (kanEdit) \ 

if (frameOEditlnLink(ev)} 

canEdit = frame->CetLinkStaf;us(ev) 1“ 
kDDT nLinkDen tination: 
else 

this GShuwCariitEdi L Alert [cv , frame); // A simple akrt 

1 

return canEdit: 

1 


T he ODFrame* parameter should lx? a display frame of your 
part that's embedded in the rcxH window of the part, noL 
necessarily the frame in which the attempted editing action was 
initiated, A display frame that's not embedded in the document’s 
root window (for example> a frame assex iated with a view of your 
part in a separate window) may not lx? embedded in the part that's 
maintaining a link destination. In this case, the embedded frame 
may not have the correct link status. 

IsEramelnkoolWindow determines whether a frame is 
embedded in the root window of the document, Before calling 
TryToEdit, you should iterate your display frames until you've 
found one for which IsFramefnKooiWindow returns kODTrue. 

DDEoolean IsFrproelnRootWindowC^Vitontnonl* DDF ranto * 

odFrame) 

[ 

TempODWiivdov tWindow = odFrameOAcquireWiivdowCev): 
return. (tWindnw 1= kODNOLL) && tWindovb I sRoot Window(ev) ; 

\ 

As a general rule, you shouldn’t disable any particular function 
in response to a frame link status of kODlnLinkDcstination before 
the user has actually indicated a desire to modify content. It s better 
to allow the user to initiate the action and icsjjond to the feedback 
that tlie part that actually owns the link destination will provide. For 
example, don’t disable the Paste menu item. Instead, if the user 
chooses Paste from the menu, call TryToEdiL, and if it returns 
kODFalse, do nothing. The user w ill already know why because a 
containing part displayed the alert saying that content can’t be edited 
at a link destination, which will be more than he would know if you 
just disabled the menu item. Similarly, don't ielurn kODFalse from 
your implementation of ODPartcDragEnrer. Instead, your 
implementation of Drop should cull TryToEdit; if TryToEdiL returns 
kODFalse, Drop should just return kODDropFaiL 

When your Part’s Content Changes 

Because your part might !x? embedded in a link source, it 
needs to inform any containing part whenever its content changes 
-— for example, when the user edits content or a previous action 
is undone or redone, h does this by calling 
ODFrame: :ContentUpdated p shown in Listing 2. Calling 
ContentUpcFited will cause each link source that emlx?ds your 
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part, either directly or indirectly, to write its content including your 
part to an QDLinkSource object (explained later under ‘‘OpenDoc 
Unking Classes’). If your part is embedded in a link source with 
automatic updating, this wili cause your Cloneinto method to be 
called immediately and your part to write out all of its content* 
Other data contained or emlx;dded in the same link source will 
also be written out, even if that data hasn't changed. Finally, one 
or more link destinations may be updated* 

In general, even with relatively small amounts of content 
involved in the update, this process takes a noticeable amount of 
time* For this reason, you don't want to make this call on each 
atomic content change — for example, every time a character is 
typed. Instead, a good rule of thumb is that ConicntUfxlatcd 
should be allied tor at least the same granularity of change for 
which you create an individual undoable, redouble action state. 
When the user begins some activity dial would create a new 
undoable action separate from die previous changes, you should 
probably call Content LI pdated if any changes have been made 
since die last time it was called. 

A corollary to this is that you should call ContentUpdated 
following the undoing or redoing of any action states you've 
created. A less obvious corollary is that you should call this 
method before losing the selection focus if any changes have 
been made since the last time it was called. Once another part 
has the focus, it may begin adding new undoable actions, and 
it's important to preserving the order of undoable operations 
that any linking-related consequences of the changes in your 
part he completed first. 

You may also choose to execute a deferred call after some 
preset or user-settable amount of idle time. YouII need to 
determine this empirically by user testing with your particular 
content (make sure that it's embedded in a link source and you 
can see the destination u pda Ling — otherwise you won't learn 
much from this!)* 


Listing 2. Making content changes known 


void LinkingPart i:ContentUpdated (Environment: * 
ODUpdatelD upeUtsID) 

( 

// Iterate over onr display frames. 

GLisiIterator iter {fDisplayFrames): 
tor (CDispIayFrameFrcocy* proxy = 
(CMsplayFrameProxy *) iter.First0 : 
iter. IsNotGompleteO ; 

proxy - (CDisplayFrameProxy*) Iter.Next ()) I 

// If I he display frame is real (has been H conneeted M or was 
// "added*), call Content Updated for the frame; otherwise, 

// ignore it. 

If (proxy >FramelsLoaded(ev>) 

pr oxy ->Get Frame(ev)->ContentUpdated{ev * 
updatelD); 

I 

) 


The bottom line is that if the user has embedded your part 
in a link source, you shouldn’t make u|xlates so infrequent that 
tile user if links the link isn’t working* nor so frequent that it's 
difficult for the user to complete a simple task. If the user finds 
that link updates are slowing performance too much, she can 
choose manual instead of automatic updating of the containing 
link source and control the process herself. The embedded part 
doesn't know when this happens, so it continues to call 
ContentUpdated as often, but the call will now take an 
infinitesimal amount of Lime to execute. 

When Frames are Embedded in your Part 

Even if it doesn't support linking, your pan must set the link 
status of every frame embedded in it. After a newly cmtxxlded 
frame has had its containing frame set to one of your part's display 
frames by calling O 0 Fra me: tSetCont a i n i ng F ra me, your part 
should call ODFrame::ChangeLinkStaius and pass in the 
appropriate link status. If your part doesn't support linking, it 
should pass in kODNotlnlink* 

Any change in the link status of any of your display frames 
(which can only be made by a containing part) causes Ojx-nPoc 
to call your part’s implementation of ODPaft:;LinkSUitusChanged. 
if your part supports embedding, your implementation of 
LinkStatusChanged should call ODFrame-Cliangd.inkStatus on 
each frame that's embedded in the frame specified in the 
ODFrame parameter to UnkStatUsChanged. 

You can always pass kODNoilnUnk to Change] JnkSratus, 
and OpenDoc will automatically set the embedded frame's link 
status to that of its containing frame. The code in listing 3 will 
work for a pan that doesn’t support linking and that maintains a 
list of emlxdded ODFrame objects* Implementing this ensures 
that parts embedded in your pan will obtain accurate information 
regarding their link status in their implementation of TryToFdit. 

Parts that do support linking must filter out frames that are 
involved in their own links. Their status within a local link source 
or destination takes precedence over the link status of the 
containing frame hierarchy. 

Human Interface Elements 

Several human interface elements are involved in 
Synchronizing content within a single document and across 
multiple documents. Well briefly describe these elements here 
without a detailed discussion of the OpenDoc API calls that 
invoke than, since those calls are covered in the OpenDoc 
Programmer's Guide. Details of the appearance and behavior of 
these interface elements are provided in the OpenDoc Human 
Interface Guidelines (Part 3 of the Programmer's Guide). 
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Listing 3 . UnkStatusChanged implementation when you 
don 7 support linking 

void. LinkingPartLink^tatusChaoged; (Environment *ev* 
ODFrame* odFraise) 

{ 

COcdidstIterator iter(fE^beddedFrames); 

for (ODFrame* odEmbeddedFrame - iter.First(ev); 

Itnr,TsKotCo»pleteC«v); odKmbeddedFrarae = 
iter.NexL(ev)); f 

TempODFrame containingFrsme = 

odEmbeddedFraJitie->AcquireContainingFrame{ev) : 
if odFrame->IsEqualTo{ev, containingFrame) 
odEmbeddedFrame->GhangeLinkStatus(ev* 
kODMotlnLink): 

J 


The Paste As dialog 

Though it also serves functions related to embedding and 
translation, the Paste As dialog (illustrated earlier in Figure 2) 
is essential to the creation of links. As mentioned previously, 
this dialog is invoked when the user chooses Paste As from the 
Edit menu or drags and drops with the Command key held 
down (and the drop target document in front). It s displayed by 
calling O DCiipboard:: Silo w PastcAsD ia log or 

ODD ragAndDrop:; $ ho w PasteAsD i alog. 

Link borders 

linking requires that the user be able to distinguish links 
from other content. OpenDoc employs link borders to show the 
user where linked data exists within a document. The user can 
display the Ixirders of all linked content by checking the Show 
Links checkbox in the Document Info dialog box. When the user 
selects content that contains a link or sets an insertion point 
inside a link, your part editor should display the link border even 
if the Show Links checkbox is off Clicking a link border selects 
the link, which is indicated by a change in the appearance of the 
link border* 

The usage and appearance of link borders are described in the 
Human Interface Guidelines. The current guidelines specify a 
border width of four pixels (two pixels created via a fill pattern, 
with one additional opaque white pixel on either side), because 
we’ve found the four-pixel width is too small a target* we 
recommend a width of five pixels (three pixels with Lhe fill pattern 
and one transparent pixel on either side, as shown in Figure 3)* 
The additional pixel also makes the difference between the 
selected and unsettled appearance clearer. Because the precise 
form of the link border and the detennination of what’s selected 
depend on die content kind, parts must implement the drawing of 
link borders as well as determine when they should lie shown 
around any given content. 

The Link Info dialogs 

When the user selects a link in your part, your part editor should 
enable die Link Into command in die Edit menu. If this command is 


invoked, your editor needs to display the appropriate dialog box (as 
shown in Figure 4) — the link Source Info dialog box if the current 
selection is a link source, or the link Destination Info dialog lx>x if the 
selection is a link destination. The link Source Info dialog allows die 
user to initiate the update of a manual link or break the link so that the 
existing content behaves as ordinary unlinked content* The link 
Destination Info dialog offers die same two choices and also allows 
die user to navigate to the source of die link. These dialogs are 
displayed via the calls ODLinkSource::ShowLinkSourcelnfo and 
01 )Li nk:: Show Li nkDcst i nationl n fo. 

In addition, these dialogs allow the user to specify when to 
send updates from the link source and when to receive updates in 
the link destination. Note that update settings at the source and the 
destination are independent. Immediate, automatic updating from 
the source to die destination can occur only within documents; 
updating can happen automatically across documents only upon 
saving the source document* Further, automatic updating from the 
source to the destination link can occur only if "On Save* is 
selected in the link Source Info dialog (the default when a link 
source is first created) and “Automatically" (the default in die Paste 
As dialog) is selected in die Link Destination Info dialog. 

"On Save* refers to the fact that changes made will become 
available to destinations in orher documents when the source 
document is saved, without additional (that is, manual) user 
intervention. From the implementation perspective it should be 
thought of as automatic. OpenDoc’s implementation hides the fact 
LhaL an update to a link source that die pan has posted 
automatically won’t propagate to a destination in another 
document until the source document is saved. 

If automatic updating is specified for a source that your 
part creates, you should automatically provide updated content 
to the link when the source content changes (or at periodic 
intervals); otherwise, your part should provide updates only 
when the user clicks the Update Now button in the Link Source 
Info dialog. If automatic updating of a destination is specified, 
it should occur whenever the part containing the destination is 
notified via the LinkUpdated API call (For destinations in the 
same document as the source, this will occur immediately after 
the update is provided aL the source. When the source is in 
another document, it will occur after the source document is 
saved following the source update.) Manual updating should 
occur when the user clicks the Update Now button in the Link 
Destination Info dialog* 

Parts maintaining automatic link destinations must register with 
QDLink objects to receive automatic notification when the ODLink 
has been updated, by calling ODLink;;RegisterDependent. 

In response to a user’s clicking Find Source in the Link 
Destination Info dialog, your editor should call 
ODLink::ShowvSourceConteni. OpenDoc responds by calling 
ODPart::RevealLink on the part containing the link source, first 
opening the source document if necessary. The part 
maintaining the link source should then select die source 
content and scroll it into view. 
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Border pattern For an unselected link 


Border pattern For o selected link 


Figure i Link border patterns. 


Link Source Info 


kind: SurfWnter Text 
Created* Han, Apr 12, 1993 4 45 PM 
Updated, Tue, Apr 1 3, 1 993 3,1 2 PM 

Send Updates: ® On Save 
O Manually 


Break Link 


[ Update No m ) 


Cancel 


OK 


Link Destination info 


Kind; SurfWriterText 

( Break Link j 1 

Created: Man, Apr 12, 1993 445 PM 

( Update Nolu j 

Updated: Tue, Apr 13, 1993 3:12 PM 

Bet Updates: ® Automatically 

( Find Source ] 

0 Manually 



[ Cancel ] 


i—»—j 


Link Source Info dialog box 


Link Destination Info dialog box 


Figure 4 L The Link Source Info and Link Destination Info dialog boxes. 


Alerts 

We mentioned earlier that Open Due provides a mechanism 
that protects against runaway recursive updates, if updates are 
automated and the user creates a link destination within its own 
source ora chain of linked content that feeds updates back to the 
source, this could lead to an endless recursion of updates (until 
an update eventually failed due to insufficient memory). 
I towever, OpenDoe detects this situation and presents the liuk- 
eyde alert (shown in Figure 5) on the second and subsequent 
recursions, allowing the user to interrupt ihe cycle or continue 
updating for one more cycle. There's no pari involvement in this 
process, other than responding to each link update according to 
the normal recipes. 

In most eases where a link destination is contained within its 
own source, the user will want to interrupt the updating because 
more than one update cycle would be pointless. So when would 
the user want to continue updating for one more cycle? Permit us 
to digress for a moment from the topic of alerts while we describe 
the situation where this would happen. 

Suppose a link source and its link destination are both 
contained within a second link source. Copies of both link source 
t and link destination 1 will then be contained in link destination 
2 S as illustrated in Figure 6. Mollifying the content of link source 1 
will cause two separate updates to link source 2 ? one due to the 


original content change and the second due to the updating of 
link destination 1. In this case, OpenDoe will past the link-cycle 
alert before completing the second update, because it has no way 
ro tdl whether a second update is justified. If the change in the 
content of link source I is propagated via link source 2 to link 
destination 2 l^efore it's propagated via link source 1 to link 
destination 1, the copy of link destination I contained in link 
destination 2 won’t reflect the final content of link destination 1 
until the user allows a second update to be completed by clicking 
ihe Update button in the link-cycle alert. 


A 

Editing a link source has caused an 
update loop. 


Click Stop to interrupt updating, 
or click Update to continue. 


[ Stop ] | Update |] 


Figure 5. The link-cycle alert . 
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Link source 2 


Link destination 2 
(copy of link source 2) 


Link source I 


Link destination 1 
(copy of link source 1 ] 


Copy of link source I 


Copy of 

link destination 1 


Figure 6 i A situation where two update cycles may be required , 


Besides the link-cycle alert, which is displayed automatically 
by OpenDoc, there are three other alerts that your pan editor 
might need to display in different Jinking-rdared situations (the 
resources and code to implement these alerts are available in Lite 
LinkingPari sample as well as in ODF): 

• if the user attempts to edit a .selection in a link destination in 
your pan, or if your part's EdiilnLinkAucjopted method is called 
(indicating an attempted change to the content of an embedded 
frame dial’s contained in a link destination in your part), you 
should display the alert shown in Figure 7. The Break Link and 
Find Source buttons do the same thing as die corresponding 
buttons in the link Destination Info dialog. 

■ If the user attempts to edit a selection that involves the content 
of more than one link destination in your part, you should 
display ihe alert shown in Figure 8. 

* If your part is emixxided in a link destination, and a call to 
ODFrameaEdttlnLink returns false, you should display the alert 
shown in Figure 9. If EditlnLink returns true, the pan that 
actually maintains the link in which your part is embedded has 
displayed the alert in Figure 7 in its implementation of 
Ed it 1 n LinkAttempted. 

Basic Mechanisms of Openixk: Linking 

Now well describe the basic mechanisms that make linking 
work in OpenDtx:, Our purpose is to give you a conceptual 
understanding that will allow you to think about how linking can 
be implemented in your part. We won’t mention every QpenDcx: 
APT call that must he made during the process; for those details, 
you’ll need to consult (he OpenDoc Programmer's Guide and the 
recipes. Most of these mechanisms can l>e provided by generic, 
reusable code, Ihe easiest way to get all of it tight is lo 
base your part on ODF. You can also examine the 
implementation in the LinkingPan sample and lift code 
from there, 

OpenDoc Linking classes 

The fundamental agents in the process of 
synchronizing link destination content with link source 
content are pairs of jxrrsistent objects, from the OpenDoc 
classes ODLinkSource and ODLink. Like oilier persistent 
objects, d icy Ye represented by storage units in the 
document draft and by SOM objects in memory when 
they’ve been internalized by a part that uses them. During the 
process of creating a link, the parr editors involved ask OpenDoc 


to create one object of class ODLinkSource and another of class 
ODLink. The ODLinkSource object provides a storage unit to 
which the pan that owns die source content writes updates as that 
source content changes, 'Ihe ODLink object provides a storage 
unit from which the pan that owns a link destination can read the 
updated versions of die source content that have been written out 
to the ODLinkSource object 

Within any document, there's always a one-to-one 
relationship between ODLinkSource and ODUnk objects. An 



Vou can't edit content at a link destination. 
You may either find the source and edit it or 
break the link and edit the contents here. 


( Break Link J [ Cancel ] ^Find_Sourcej| 


Figure 7 Alert displayed when a user 
tries to edit a link destination. 


O Yeu haue selected content in multiple 
link destinations. You can only work 
with one at a time. Select content 
within a single link and try again. 

i ■« i 


Figure 8. Alert displayed when the user 
attempts to edit multiple link destinations. 


o 

It isn't possible to edit this 

link destination. 




Figure % Alert displayed when the part 
maintaining a link destination can't be found. 
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ODLinkSource object is also always associated with exactly one 
ODPait instance* and by that part with one specific content subset 
within it. In contrast to this* within a single pan or scattered among 
multiple parts there can be any number of link destinations, each 
of which obtains comem updates from the same ODiink object, 
and each of which is responsible for maintaining and updating a 
separate copy of the source content* 

Writing content to an ODLinkSource object and reading it 
from an ODLink object are very much like performing the same 
operations with the ODClipboard and ODDragAndDrop objects, 
Since parts are required to support these operations* this key 
portion of linking support should require little additional code in 
your part editor. However, unlike ODClipboard and 
ODDragAndDrop objects, there can t>e any number of paired 
ODLink and ODLinkSource objects in existence, and these 
objects and the data within them persist when a document is 
saved, dosed, and reopened. 

Besides ODLink Source and ODLink, five other classes relate 
to OpenDoc linking: 

• GDLinkManager Isn’t used by part editors* but. its accessed 
explicitly by explainer applications (traditional applications that 
supjx)rt embedding of OpenDoc parts)* 

• GDLinkSpec is a nonpersistent class used as a token for initially 
establishing a link source-link destination connection* 

■ ODLinkTnfo is a simple structure maintained by part editors for 
each distinct link destination. It records information needed 
when displaying the Link Destination Info dialog, and also 
certain characteristics of the particular destination, such as 
whether it’s to be updated manually or automatically. 

• ODPasteAsResult and ODLinklnfoResult are simple structures 
that provide access to user feedback from the Paste As and Link 
Info dialogs. 

How a link is established 

Let's look at how a link is established between parts within 
a document. The source part Cthe part that places data on the 
Clipboard or in a drag and drop object) and the destination part 
(the part receiving the paste or drop) each follow a different 
procedure. 

A part that's copying content to the Cliplx>ard or a drag and 
drop storage unit advertises its ability to create a link by writing a 
link specification in addition to content. It does this by calling 
ODDraft::CreateUnkSpec f passing in a reference lo the ODPan 
object as well as an ODByteArray argument containing a private 
token that will later allow it to identify the subset of content from 
which a link is to be created. The token can be anything the part 
finds useful, such as a pointer to an object in the part representing 
the potential link source and its content* The part then adds the 
kODPropLinkSpec property to the data transfer storage unit and 
calls ODLink$pec::Write, which writes the link specification out to 
the property* 

The method shown in Listing 4, simplified from LinkingPart, 
takes advantage of CLinkSouroe being a reference-counted class. 
It isn’t required that the class representing a link source in your 
content be reference-counted (ODLinks and ODLinkSources are 


reference-counted)* but it helps* In our method it avoids the need 
for additional code to determine whether the linkSrc which may 
or may not lx: a new ly created object with no other references, 
needs to be deleted in the event that creating or writing the link 
specification fails. The reference-counted CLinkSource reference 
returned by this method will be stored by the caller in an 
appropriate location. 

Reference counting in Lin king Part is inherited from the 
mixin class MRefCounted. Its constructor initializes an f Ref Count 
member to 1. The Acquire method increments this* The Release 
method decrements it and if decremented to 0, invokes the 
object's destructor by calling delete this* Objects that have 
"acquired" a reference to a reference-counted object call its 
Release method and dear their reference, rather than explicitly 
deleting it when it's no longer needed in that context. This 
eliminates the need to explicitly decide which of two or more 
objects that maintain references to a single other object is 
responsible for deleting it. 


Listing 4, Writing a link specification (source juirt) 


CLinkSource* LinkingFart; :CreateLirikSpec(Environment* 


ev * 

I 


ODStorageUnit* su); 


// Determine whether the selection ran he published 
if (!fSelection->CanPubiinh(}) 
return kODNULL; 


// [f the selection txdng copied is exactly a link source, we shoukl 
// use That, not create another* 

CLinkSource* linkSrc “ fSolection->FindLinkSource[); 
if (linkSrc = kODNULL) 

// Make a new link source based on the current selection. 
linkSrc “ new CLinkSourccffSelect ion* , ,*); 
else 

IinkSrer)Acquired : 

ODLinkSpec* linkSpec - kODNULL: 

ODVolaUleflinkSpec): 

TRY 

// Make die data a pointer to our link source object* 

TempODByteArray date * CreuteByteArrayUlinkSrc, 
sizeof(linkSrc)); 


UnkSpee = tMs->GetDraft (ev) >CreateLinkSpec lev, 
this->GetODPart(). 

data): 

su >AddPrupt? rty (ev, kOD PropL inkSpe c): 
linkSpec->WriteLinkSpec(ev. suh 
CATCH_ALL 

linkSrc->Release(): 
linkSrc = kODNULL: 


// Failing to write a link spec isn't fatal.The u*ser just won t Ik 
// able to create a link, so dont RERAISE, 

ENDTRY 


if (links pec.) 

delete linkSpec; 
return linkSrc; 
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GmPublish determines whether it T s appropriate to allow 
creating a link source from the selected content. The editor must 
enforce two rules; 

* A link source shouldn't he Cleared from a selection that includes 
part of a link destination, I localise when the destination updates 
there won't he any way to determine what portion of the 
updated content will affect such a link source. 

* A link source shouldn't lx. 4 created when its content is exactly 
the content of a link destination; in this case the user should 
create additional destinations directly from the original source 
rather than creating a chain of links. 

Parts may impose additional restrictions. FindlinkSource 
determines whether the current selection is exactly tite content of 
an existing link source. If so, Jinks pec will reference the ousting 
CLinkSource object. The implementations of both CanPublish and 
Find Link Source are too content specific to lx: worth showing here. 

When the user chooses Paste As from the Edit menu (die menu 
command is kODConmiandPasieAs) or drags while holding down the 
Command key (the kODDropIsPasicAs bit is set in the drag 
attributes), the part in w hich the user wants to create a link destination 
calls the QDClipboard;:5howPasteAsDialug or 

ODPragAndDrop;:ShowPasicAsDiaiog method, passing kODTrue 
as the can Paste Link parameter. If a link specification property is 
present in the data transfer storage unit, the “Paste with link" 
checkbox is enabled in the Paste As dialog box, The user’s choice 
is indicated in the pasteLinkSetting field of the 0DPasteAsResult 
structure. 

When the user has chosen to create a link, the drop or paste 
target obtains an ODLinkSpec object by calling 
ODDraft-CreateUnkSpec, this time passing kODNTJLL arguments 
for the QDPait and the ODRyteArray data. It then focuses the data 
transfer storage unit on the kODPropLmkSpec property and calls 
ODLinkSpec: :Kead + This produces an ODLinkSpec object identical 
in content to the one that was created at the source of the copy. 

The destination part then passes the ODLinkSpec to 
ODDrafi-Acqulrelink* OpenDoc obtains an ODLinkSource object 
by calling ODPart::CreateLink on the source part (the link 
specification was initialized wkh this reference), passing the 
ODRyteArray contained in the link specification as an argument. 

Hie source part’s implementation of CreateLink ("Listing 5) 
identifies the content that needs to be linked from the ODRyteArray 
data. If the specific set of source content isn't yet associated with an 
ODLinkSource, it calls ODD raft ::CreateLinkSource to obtain a new 
ODLinkSource object; otherwise, it returns the one it already has. At 
this time, die source part also updates the content of the 
ODLinkSource object For an existing link, tills ensures dial each 
representation of the linked content that was available on the 
Clipboard or in a drag and drop object will also be available to die 
new link destination. 

CLinkSourceaCreateLink, which is called in Listing 5 for a 
newly established link, calls ODD raft: :Cre ate l.inkSou fee, and also 
its own ContentUpdated method, and takes care of other details 
that ensure dial the newly linked content behaves as it should. 


Listing £ Creating the link (source part) 


ODLi nkSource* LinkingPart::CreateLink(Environmmu ' cv H 

ODByteArray* data) 

I 

CLinkSource* pandingSource - *[(CLinkSouit:e , ‘Jdata- 
>_buffer); 

ODLinkSource* odLinkSource - pendingSoiirce- 
>GetODLinkSource{)■ 

If (odLiukSource — kODNULL) I // New link sntirre 
udLinkSource = pendingSourceDCreateM uk(evjj 

//To support asynchronous calk to this methtd resulting from ,i 
// triras-doaimcni Command-drig link creation, InhiateDrag posted 
// a CCrcatrfinkSrmTvt* Action to the undo history *)lBt in case* 

// and stored a reference in the pending CLinkSourec. 

CCrcaleLinkSourceAction* linkAction ** 
pendiitgSource- 

JGetFeadingActionO; 

if (IinkAction kODNIILL) \ // Paste As from the (Itpboanl 

1inkAction = new CCrudleLinkSoureeActiontthiiri ; 

]inkActlan >Pcrfor»(ev); 


//The action won't ever undo or redo anything unless it has a 
// link source reference. 

linkActioU’^SetLinkSmirce (pcndiiigSource) ; 

I 

else 

// O.inkSource: ComcntUpdated actually writes or promises the 
// current data to the link sourer. 

peiidirigSource->ContenUlpdated{ev, kODUnknownUpdate, 
kODTrue): 

odLinkSource'>Acquire(ev); 
return odLinkSource; 

1 


An ODLink object associated with the acquired 
ODLinkSource is returned as die result of die destination part's call 
to ODDraft::AcquireUnk. The destination part acquires the actual 
linked content by reading content from the ODLink object. 

Creating links between documents is somewhat more 
complex for OpenDoc, though this is largely transparent to part 
implementations. If involves the help of the ODLink Manager objects 
in each session and the creation of an edition file. In this case, calling 
the CreateLink method of the source part and the ensuing update 
occur asynchronously after the drop or paste is completed. Though 
this affects the way undo transactions are posted, the existing 
recipes already take this into account. The call to pendingSource- 
>GetPendingAction in Listing 5 is related to this issue. 

In addition to establishing new links, Clipboard and drag and 
drop operations can move or copy existing links with their content* 
The OpenDoc Human Interface Guidelines specify when link 
sources and destinations contained in content that is being 
transferred should be established where dropped or pasted. Part 
editors determine whether a link source or destination can be 
written to a data transfer object, and whether a link source or 
destination can l>e established when read in from a data transfer 
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object, by validating storage unit references and cloned object IDs as 
Indicated in the linking recipes, in addition to writing out references 
to ODLink and ODUnkSource objects as described there, part 
editors must write out additional content model-specific data for 
each link that allows its relationship to a specific subset of content u> 
be reestablished when it's read back in. 

IIow and when links are updated 

Part implementations have complete control over the 
updating process. You can think of die ODUnkSource and 
ODLink objects as the ends of an open tube, sloping toward the 
ODLink end. Source parts place updated content into die 
ODUnkSource end by obtaining access to die ODIinkSource’s 
content storage unit and writing die source content to it f then 
calling ODUnkSource:: Content Updated. Destination parts retrieve 
content from the ODLink end by obtaining access to its content 
storage unit and reading the new content from it. 

Multiple representations of link source content can be promised 
when updating. The ODUnkSource object will immediately fulfill 
promises for those representations that are in use at one or mote link 
destinations. Any remaining unfulfilled promises will never need to 
lx 1 fulfilled (Promises are defined and discussed on pages 330-332 
of die OfMfnDoc Programmer's Guide.) 

The decision about when to write content to the 
ODUnkSource object and when to read it from the ODLink 
object depends on whether link updating is designated as 
automatic or manual Manually updated link sources in your 
pan don't put data into the ODUnkSource object, and manually 
updated destinations don't retrieve data from the ODLink 
object, until the user requests an update for a particular link in 
one of die Link Info dialogs. 

With automatic updaiing, a link source writes modified 
content to the ODUnkSource object without explicit user 
intervention* The decision about when to do this is content 
specific but should follow* the guidelines discussed earlier in 
this article under “When Your Part’s Content Changes;" A pan 
that contains one or more automatically updated link 
destinations for a given ODLink object will replace the existing 
content of each one by reading new content from the ODLink 
object when it's notified that the link conteni has changed via a 
call to its Link Updated method. 

Update IDs 

Each Node of part content at the source or the destination of 
a link must have an assrx ialed update ID, which is fundamental lo 
the updating process. An update ID Ls created when the source 
pan calls ODSessioncUniqueUpdaielD. This ID makes it possible 
to do the following: 

* protect against runaway recursive updating 

* control the enabling and disabling of the Update Now button in 
the Link Info dialogs 

* determine whether an immediate update notification is required 
when ODLink::RegisterDependent is called 

A new update ID is obtained where content has been modified, 
even if the part editor doesn’t support linking. It’s passed to 


ODFrame::ContentUpdated, which propagates it to all containing 
parts via their Fan bedded Fra me Updated methods* It becomes 
associated with the current content of a paired ODUnkSource and 
ODLink when it’s passed to ODLinkSounte: :ContentUpdated It's 
retrieved by link destinations as they ujxlate. 

When a single ODLinkSource object has its Conteni Delated 
method called twice consecutively with the same ujxlute ILL it will 
display the link-cyde alert to allow the user lo continue or abort the 
update at this point. For this mechanism to work, the update ID 
obtained when updating an automatically updated link destination, 
or from EmbeddedFra mellpdated, must Ixr passed on to any 
automatically updated link source that contains the modified 
content, This isn’t necessary for manually updated links, since you 
can't liave a runaway update cycle when a manually updated link is 
involved; to suppress the mechanism in this case, a new update ID 
should be substituted before calling 

ODLinkSourceaContentUpduied or OD Frame; :Ox>meniUpdated 
(the latter applies only when the destination is manually updated), 

Enabling of the Update Now button in the Link Info dialogs 
and triggering or an immediate notification in 
ODLink: :Registerl)ependem are simply controlled by comparison 
of the update ID passed in (as a separate parameter to 
RegiSterDependent and ShowlinkSourcelnfo and as a member of 
an ODLinklnfo record in ShowUnklnfo) with the update ID stored 
in the ODLink or ODLinkSource object when 
GDLin kSou rce; ; Co n re n r U pditied was last ca l I ed. 

The ODCiipboard object also associates a unique update ID 
with the current Clipboard contents. This in turn is used by a linking 
part to determine whether it should remove from the Clipboard a 
link specification that s no longer viable (for example, if the content 
that was to comprise the link source is removed, or an existing link 
source is broken). This usage is independent from the usage of 
ODUpdatelOs in the link updating process. 

Embedded frames and updating. 

ODPart: Em beddcdFrameU pdated must be implemented 
by container parts that support linking. Die implementation 
should identify any link sources in which the specified frame is 
embedded. Each such automatically updated link source should 
be updated at this time. A manually updated link source will 
need to be tagged (typically with the ODUpdatelD passed To 
EmbeddedEramellpdaied) so that the Update Now button will 
l>e enabled the next time the Link Source Info dialog is invoked 
by the user. 

When tile content of an embedded part changes, the part 
notifies each of its display frames. The containing part may 
consequently receive multiple mils to ErrilxddcdFrameUpdated, 
each specifying a different emlxxJded frame. To prevent unnecessary 
data transfers anti unnecessary display of the link-cycle alert by 
Open l)oc\ the implementation of EmbetldedFramet 1 pda ted must 
perform some filtering before propagaLing the update to any 
containing link sources. 

In LinkingFait, as in many container parts, each ernlxxkled 
frame is represented in the part by a frame proxy object, and all 
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the embedded frame proxies associated with a single cmtxxlded 
pan are grouped in a single proxy object in the part's content 
model When the proxy containing the frame specified in 
luiibeddedFramcUpdated is identified, it's responsible for 
updating any affected link sources. Before doing so, it must 
determine whether the update is merely a repeat of a previous one 
via an additional embedded frame If so, it suppresses updating 
the link source again with the same II). 

This isn’t just a matter of storing the update ID each time 
Em bedded Fra met 1 pda ted is called and ignoring subsequent 
updates with the same ID. As discussed earlier, there are legitimate 
siluations where the link should lx h updated twice with the same 
ID so that OpenDoc will display the link-cycle alert. Jhe extra 
HmbeddedFrameUpdaled calls that should lx‘ ignored nor only 
duplicate the update ID of a previous call that involved the same 
proxy bill are also associated with an emlxxlded frame that hasn't 
previously presented an update using the same ID. 

CContentObj:;EmlxxldedFrameUpdated is called on each 
shape in the part content from UnkingFarts override of 
ODPart::EmlxxklcdFrameUpdated, until one of them returns true, 
indicating that the "shape” containing the specified frame has 
ixxrn notified. This method, which returns kODFaise for any 
none ml adding shapes, is overridden in CRmbeddingShape as 
shown in listing 6. 

Linking In your Part 

The previous section, in describing the basic mechanisms of 
OpenDoc linking, touched on some of the responsibilities of part 
implementations. The real work in supporting linking is in 
managing the relationships of the ODLink and ODLtnkSource 
objects with specific content subsets, and particularly in managing 
the replacement of content when link destinations are updated. 
These aspects are inherently content specific; however, we have 
found tliat certain basic structures are useful across a broad range 
of content models and have based the discussion and examples 
on these. 

Classes relating to specific content 

We’ve found that some classes are generally useful for parts 
to define regardless of their content kind. A class or hierarchy of 
classes representing the part's content — ClinkingPartContent, in 
linkingPart — can lx; used to represent the entire part’s content, 
the selection, promised data, contents of link sources and 
destinations, and the data stored in undo actions. It’s possible to 
hide a lot of content-specific behavior in this class. By 
manipulating content class objects, code that implements Edit 
menu choices, dragging, dropping, and managing links can be 
more or less generic. CDF provides an abstract content class that 
you must override to represent your part s specific content. 

A fundamental behavior that characterizes the content 
class is the ability to write the content to an OpenDoc storage 
unit, and to initialize itself by reading from a storage unit. Since 
OpenDoc requires that the representation of content be 
identical when externalized to tile pari storage, or cloned to the 
drag and drop object, the Clipboard, or an ODLinkSource- 


iisting 6. Overriding CContentC )/?/,/ imbedded frameUpdated 


ODBoolean 

CEmbeddingShapR: rEmhfvidedFraineUpdflted (Environment * nv , 
ODFrame* frame', ODUpdatelD nevID) 
t 

CEmbRridL'ditcLmeFroxy* foundFroxy =* rhis- 
>G0t Proxy tori' ratne{ev. frame) ; 
if (fcmndProxy — NULL) 

return kODFaise ; // Frame not in this slrape - keep looking. 

ODBoolean shouldIJpdaieLinks ■ kODFaise; 
if [newlD = f LaslUpdate) I // Wd' re lotting 3. possibly 

// redundant update. 

If (foundProxyDCetLastUpdateO “ nowID) i 

//A second update with the current ID from file same frame 
// means that tills is a legitimate update. 

shouldtJpdatfiLfnks ■ kODTrue; 

//We need to restart the algorithm by clearing euch proxy. The 
// state leaving here is equivalent to the state leaving the 
// else danse below. 

COrdListlterator iter(fT ratnnPro*iea )i 
lor (CEmbeddedFrampProxy* f rone Proxy = 
[CEmbeddedFraraoPrQxy■)tier,First(); 
iter.IsNotCoapletcf); 

frameProxy ~~ 

(CEmbeddedFrampProxyM iter .Next {)) \ 

fraFneProxy >SetLastUpdate[kODttnknftvnUpdiiLe) ; 

I 

I 

I 

else I //We haven’t seen this update ID before,so propagate the 
// update. 

fLastUpdare ” newiU; 
shouldUpdaleLinks = kODTrue: 

I 

ruundProxyMSetLastUpdate (nevTD); 

// Passing kODFiLse to OhjcctUpdated allows cadi conuimng link 
// source to be updated regardless of its previous update ID. This 
// allows OpenDoc to detect an unnecessary cyclical update and 
// respond appropriately, 

If (shouldUpdateLinks) 

Lhis>ObjectUpdated (ev, change, kODFaise) ; 

return kODTrue; // Found the shape with die frame, so stop looking 


ODLink pair, it's convenient to use the same class to implement 
each of these behaviors. 

link sources and destinations can each be represented by a 
class dial .stores a reference to an ODLinkSource or ODLink object, 
along with essential state information for interacting with those 
objects and a reference to a content object. For a link source, die 
content object represents the subset of the parr content that will be 
written whenever rhe ODUnkSource object is updated. For a link 
destination, it represents the content that was read from die ODLink 
object during the mast recent update. Ihe class declarations in 
Listing 7, simplified from those in LinkingPart, represent the more 
generic data members of these classes. 

Despite the obvious symmetry between these classes, there 
are fundamental differences between link sources and 
destinations. Link sources can overlap or be nested, can contain 
entire link destinations, and don’t affect the operations that can lx: 
performed on their content. A given portion of content can be 
involved in a number of distinct link sources. An existing content 


In MacTech 


SupPomiNC. Links in Your OpenDoc Part 


93 






Listing 7. CLinkSource and CLinkDestination class declarations 


class CLinkSource 

t 

publici 


void ContentUpdated(Environment* ev. QDUpdatelE updateTD); 
private; 

ODLinkSource * fOBLinkSource; 


GDTD fODID; 

ODUpdatelD ftJpdatelD: 

OEUpdateTD fFendingID: 

QEPart* fGDPart; 

CCreateLinkSourceAction* fPendingAction; 
CLinkingPartContent fContent; 


// Used in obtain IDDLinkSource after cloning its storage unit 
//For ()DLinldsouix:e::ComcmUpdatcti and ShowIinkStimeirifb 
// Determines when to remove a link spec from the Clipboard 
// For ODlinkSourcc: :Sctin)urccPart 
//Action data created during drag initiation 


class CLinkDestination 
I 

public; 

void LinktJpd a ted (Environment* ev* ODEpdatelD updateTD); 


private; 

ODLink* fODUnk; 

ODID fODID; 

ODLinklnfo fLinkinfo: 

OEPasteAsResult 1 fFasteAsResolLi 
OBSoolean fRegistered; 

ODParf fODPart: 

CLinkEndAclion* fEndAction: 

CLinking P a r t Con tent * fContent j 


// Contains update!!), passed k> ShowIinkDesti nation Into 
// Choices Ibr embed/merge. editor, translation etc. 

// is this registered for automatic updating? 

// For ODlink: :Regbtaikpctxlcm 

// For ending paste link transaction asynchronously 


selection Incomes the content of a link source when the user 
creates a link based on dial selection. 

In contrast, link destinatioas ain't overlap or contain other 
link destinations or link sources, and place strict limitations on the 
operations that can l>e performed on their content. A given 
portion of content can lx involved in only one link destination. 
Existing nonlinked content never becomes the content of a link 
destination. When it receives its initial update, the link destination 
is always populated by a copy of die content that comprises the 
associated link source. 

Figure 10 shows how the CLinkSource and CLinkDestination 
objects work with the OpenDoc objects descrilxd earlier The 
CLinkSource object maintains the relationship between a portion 
of content (CPartContent) and an Of) Link Source object. To update 
the ODLinkSource, ii obtains from it a reference to an 
ODStorageUniL and passes that to the CPartContent object, which 
in turn writes itself to the storage unit The CLinkDestination 
object maintains the relationship Ixnween an ODlink object and 
the portion of content that’s to lie replaced when the link 
destination updates, To update the destination, it obtains a 
reference to the GDStorageUnit from the ODlink object and 
passes that reference to an empty CPartContent object, which in 
turn initializes its content by reading from the storage unit. Finally, 
it performs the necessary operations to disengage its old content 
from the part content and engage die new content. 

Updating link destination content 

Now well discuss some issues you’ll need to address if your 
part .supports link destinations. 


When a link destination is updated, there’s no way that the 
new data can lx- 1 apportioned to update more than one distinct 
data object; all of the old link destination content must be 
replaced with all of the update content. A single data object tan 
lx updated in place, or multiple objects can lx removed and 
replaced all at once. (The latter can be messy, since references 
to the replaced objects may need to lx removed and replaced in 
numerous locations: die part content, the selection, one or more 
containing link sources, and any undo action da La, such as a 



Op&nOoc -► Stored reference 

Part obiaeli Dnio flow 


Figure 10, How the part objects work with the OpenDoc objects. 
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pastu action in which a link destination was pasted.) In either 
case, this implies that any object (for example, link sources or 
undo action data) whose relationship to link destination content 
musi be preserved across an update must refer to all of the link’s 
content. This in Lurn implies that in general, changes can’t be 
made to just a portion of link destination content. 

A portion of a link destination can lx: selected and copied to 
the Clipboard or dragged and dropped if the result of doing so is 
a copy rather titan a move, A link source cant be created from 
such a selection. Such a selection itself also can't remain selected 
across a link update because there’s a way to decide which 
portion of the new content should be selected. Parts can dnxxie 
to allow some non-undoablc local modifications to a portion of a 
link destination's content. These, like the selection, will lx* blown 
away by the next link update. 

In supporting the multiple undo/redo capability required of 
all Open Doc parts, an important simplifying assumption is that 
an action stale is responsible for transitioning back and forth 
between two fixed stales of the part s content. While the content 
changes that drive the link updating mechanism are undoable 
editing actions, the link updates themselves are never “undone." 
When the user undoes or redoes a change to link source content, 
the QPUnkSource object and ultimately the link destination 
content are simply updated with the current version of the 
content. There's no median ism in OpenDoc that allows an 
updating destination to recognize a reversal and simply restore 
the content from undo data rather than reading it in from the 
OI)Link object again. 

For some content models, this may lx a moot point. For 
example, for simple text content there’s really no meaningful 
distinction, since Lhe resulting text would lx the same whether it 
was transmitted through the link or restored from action data 
stored locally at the destination, Tcxl characters are unique system 
resources. The “objects’* themselves, referred to in the text stream 
by ASCII or Unicode tokens, are the same, no matter where 
identical token streams come from. 

For other content models, specifically those that include 
embedded content, this is an issue that bears some analysis. The 
LinkingPart sample represents each link destination and its 
included content as a single object within its content mode!. Link 
updates do replace multiple individual objects (this is inevitable 
when the link content can consist of multiple embedded frames), 
but tins ts hidden from the rest as an update to a single object, 
which itself persists, Ihis neatly sidesteps the undo question. 
From outside die GlinkDestination object, undo actions are still 
operating on fixed undone and redone states since the objects 
visible to them remain constant. The data that underlies the 
updated link destination may consist of different objects, though 
these objects are equivalent in that they're new copies of the same 
content at the link source. 

Likewise, the effect of link destination updates on containing 
link sources is invisible to the GUnkSource object. Of course, its 
Contend, i pel a ted method will lx called to propagate the changes, 
but the representation of the link source content in the 
GUnkSource object will remain constant, because only ihe 


same CLinkDesiinaiion object is referred to T never the content 
that's replaced during an Ufxlate. 

There ain't no such thing as a free lunch The price paid for 
simplifying link destination updates is that the CLinkDesrination 
object has to serve as a proxy for its actual content, providing 
pretty much t he entire interface for non I inked embedded parts 
and any intrinsic content. The good news is that in LinkingPart, 
operations on all content are always performed via a containing 
CLinkingPaitContent object that iterates over the actual elements 
(link destinations and embedded parts). For many cases, 
CLinkDestination merely passes the method call through to its 
own fContent member. 

Breaking a link destination 

lhe re’s one exception to the rule that objects that refer to link 
destination content across updates must refer to the entire link 
destination content. Breaking a link destination, which the user 
accomplishes with Lhe Link Destination Info dialog, causes Uie 
previously protected link content to lx have as ordinary nonlinked 
content. The restrictions on operations on partial link content that 
permitted the convenient hiding of the underlying transient data 
are no longer in effect. The user can now apply multiple undoable 
editing operations to random subsets of the content that used to 
be contained within the link 

If these actions and the breaking of the link destination are 
then undone, the action data that refers to portions of the linked 
content will persist, Ixcau.se the breaking of the link and die other 
undone actions can still lie redone. Supposing the user then 
undoes some action that was performed lx-fore breaking the link 
and tliut affects the associated link source, then redoes dial action, 
the link destination will lx* updated twice. What will happen if die 
user then redoes breaking the link destination and proceeds to 
attempt to redo some of the actions on portions of the linked 
content that followed backing the link? (OK, the user can't make 
up his mind. It could happen!) 

Again, whether this needs attention depends on the content 
model. References to ranges of text should remain valid after all the 
undoing and redoing, in LinkingPart, this matters a lot. Individual 
emtxdded shapes have to lx replaced during each link update, yet 
somehow must survive to support the above scenario. You may lx 
able to apply an approach similar to that described below if dlls 
issue is likely to be problematic in your part. 

Tlie key 10 LinkingParfs management of Lius case is dial all its 
content elements and its CUnkingPartContent objects arc 
reference-counted. The following vastly simplified code is 
executed in the LinkUpdated implementation (in the actual 
sample code, newGontent is initialized from the link's storage 
unit in a failure-handling block): 

CLinkingPartContenT* newContcat = nev 

CLinkitigPflrrContetn {£Part): 

newCnntent >IrutLinkingFartContent (ev, su); // Read fmm link's storage, 
f Con tent > K emoved (e v ) : // Make old stuff disappear 

fContent >ReleaseO; 
fContent = newContent: 

fContent’ > Adde d t ev); // Turn on'* the new content. 
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Typically, the ClinkDestimtion thal’s being ujxiated owns 
tlie only reference to its fContent. Releasing it makes its reference 
Count go to 0, which causes it to be deleted This in turn causes 
the emliedded shapes contained in it to be released and deleted, 
which makes all kinds of permanent things occur, like calling 
ODFrame::Removed on the embedded frames, Hul in its 
constructor, CBreakLinkAction — the object responsible for 
initiating, undoing, and redoing breaking a link — does this: 

fTiinkContent - fLixikDestitiation )GctContent [) ; 
ri;3nkConterit->Acquire{); 

1'his protects the link’s content from any permanent 
damage when the link is updated, causing it to behave the 
same way that content removed by an undoable cut or dear 
operation would behave. CLink Destination:: Break Link takes a 
CLinkingPartContent* argument, ft’s passed the 
flinkContent reference from CBreakLinkAction::Do and 
CBreakLinkAction:: Redo. Before doing whatever is required 
to make the link content available to the pan for unrestricted 
interaction, BreakLink performs the operation shown in 
Listing 8, 

Besides being similar to Link Updated, the operation is also 
identical to what would be done if link updates themselves 
were undoable and redouble. Our ability to perform this 
operation transparently to the user depends on the knowledge, 
which is absent during LinkUpdated but is implied by the 
design of OpcnDods undo mechanism when redoing breaking 
the link, that any link updates that may have occurred while the 
link wasn’t broken must have come in complementary pairs. 
The resulting content of the link when it’s rebroken must at 
least appear to be the same as its content when the link was 
originally broken. 


Listing & Safely breaking a link destination 


void CLlnkDestination;:BreakLink(Environmum ' nv, 

CLinkingPartContent 1 content} 
I 

// ti ihc link updated vvltik' the break link was "undone," content 
// (the content when it was first broken) will lx: ditlrrcnt from 
// [Content (iIk present link content). If so, first substitute the 
// original for the pmsent content, 
if (content t* fContent) 1 

//Hiis is similar to a link update.only instead of reading new 

// content from the link, wc just use the old content 

f Content - >ftemoved (ev j : // Hus will empty our selection. 

fContent■>Release(); 

fContent - content; 

fContent >Acqntro(): 

fContent >Added(ev) ; 


// Disable the link destination and make whatever is in fContent 
// available as ordinary unlinked content to the part, 

I 


When initially breaking the link, or when redoing breaking 
the link when no updates have occurred, this operation is 
bypassed because content and fContent remain equivalent. In 
any case, we're ensured that each time the break link operation is 
redone, die part content is restored to exactly die same state it was 
in (with exactly the same embedded frames) when the link was 
initially broken. Any subsequent actions that had Ixren }>erfomied 
on that data can now be redone safely. 

You Can Do It! 

We hope that both users and developed will find imaginative 
ways to take advantage of linking. We would especially like Lo 
encourage developers of part editors diat support embedding to 
seriously consider support for linking. The combination of 
embedding anti linking effectively extends a degree of linking 
capability to ail OpenDoc content. It allows users to create links 
consisting of one or more embedded parts within or between 
containers that support linking. The content of an embedded 
frame in a container lhal supports linking can also lx? merged into 
the content of a like part as a link destination if LhaL part supports 
linking, even if it doesn't support embedding* Conversely, content 
from one pan that supports linking can become the source for an 
embedded frame link destination in any container that supports 
linking. 

Supporting linking in your part can be easy or challenging, 
depending on your part’s content model. The model represented 
in LinkingPart and discussed in this article is probably one of the 
more difficult kinds to handle. Nonetheless, once we thought 
aixjut it enough and tried a few different approaches, we were 
able to come up with reasonably simple mechanisms to handle 
die worst edge cases. 

The good news is that a lot of the code you’ll need to support 
linking is already written. Whether you choose to inherit linking 
behavior from ODF (the recommended route, especially if you’re 
doing emlx^dding, too) or to base your pari on the LinkingPart 
sample code, you can build on what's been provided and focus on 
the details that will add the most value to your part. 


Thanks to our technical reviewers Craig Carper Date 
CurbouK Vincent Lo, and Uric SimeneL E 


Related Reading 

* "The OpenDoc User Experience" by Dave Curbow and Elizabeth 
Dykstra-Erickson, develop Issue 22. 

* "Getting Started With OpenDoc Storage" by Vincent Lo, develop 
Issue 24. 

* OpenDoc Programmer's Guide for the Mac OS by Apple 
Computer, Inc (Addison*Wesley, 1995). In particular, see 
"Linking" (in Chapter 8, on pages 372-400) and "Using Links" 
(in Part X "Human Interface Guidelines/ on pages 604-615). 

* OpenDoc Cookbook for the MacOS by Apple Computer, Inc. 
(Addison-Wesley. 1995). 
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by Ingrid Kelly 


The New PrGeneral Version Opcode 


For die past 12 years, printer driver 
developers have used the print record’s 
wDcv field in die TPrStl data structure to 
store their device information. Specifically, 
they’ve consistently used the high-order byte 
of this field — commonly known as the 
wDev ID — to store the device code. 
Unfortunately, due to die design limitations 
of the print record and die wDev field, the 
Printing Manager allowed for a maximum of 
only 2% IDs, Surprisingly enough (ha ha) T 
with the expansion of die printer market, 
we're running out of number! As a result, 
with LaserWriter driver version 8.4, we’ve 
added a PrGeneral opcode and new 
structures to the Printing Manager so dial 
developers can work around this limitation. 

Both printer driver and application 
developers need to add code to support 
this new- information, but the changes are 
minimal. Accompanying Lhis column on 
die MacTech Web site is a sample 
application, called PrGeneral Version, 
that shows you how to properly retrieve 
die new version information when your 
application is kxiking for the features of a 
particular printer driver. 

Tut; New PrGf.nf.rae Opcode: 

KPEVERSIONOP 

LaserWriter driver version 8.4 iniioduccd 
several new PrGeneral opcodes, including a 
new opcode for driver version information: 
kPrVersionQp, Using kPrVereionOp Is now r 
the recommended way for applications to find 


out the printer driver currently in use. Remember that for printer 
drivers dial haven't updated to use this new PrGeneral opcode, your 
application needs to keep its wDev-checking axle as well. 

For more information on the exrended print record 
opcodes introduced with LaserWriter version 8.4, read the Print 
Hints column The All-New LaserWriter Driver Version 8.4" in 
develop Issue 27, There you'll find a table that lists all the other 
PrGeneral opcodes supported in Apple printer drivers, See the 
article “Meet PrGeneral, the Trap That Makes the Most of the 
Printing Manager” in develop Issue 3 for more information on 
PrGeneral. 

What Printer Driver Developers Need to Know 

From now on, Apple's Developer Support Center will assign all 
printer drivers a wDev ID of 255* If you have an old wDev ID number 
(which is less than 255), you should .si ill use the number you were 
assigned .so that you don't break any applications that vary their 
behavior based on your driver's wfJev, En addition, you should 
implement the new kPrVcrsionOp opcode as described here .so tiiat 
new applications can take advantage of it with your driver. 

Listing 1 shows the new opcode and structures that you'll 
need to implement in your PDEF 7 resource* You need to place 
your creator type in the driver.creator field of the TPrVersion 
structure. You should also place your version number in 
driverrelease so that application developers know what version of 
die driver is available. 

The release and interfaces fields have the same format as 
the first long In a vers' resource — that is r the following four 
Tbyte values: a major version number, a minor version number, a 
revision stage (development = 0x20, alpha - 0x40, beta = 0x60, 
and release = 0x80), and a prerelease version number. 


Ingrid Kelly (inge@apple.com) provides technical support for developers as a member of the Multimedia, Printing, Imaging, and 
Graphics group in Apple's Developer Technical Support. When she’s not answering developer e-mails or trying to hold die record 
for most Ted motes written in DTS, Ingrid can lie found refilling her office candy bin, trying to come up with the ultimate chocolate 
chip cookie recipe, or attending Navy Blue Angels flight team demonstrations with her husband, Lance. 
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Listing 1. The new version opcode and structures 

emim { 


kPrVersionOp - 22 

h 

// LaserWriter version HA sod Uutr only 

typedef struct 1 

0 Slype arc hit e C t u r e; 

OSType creator; 

unsigned long release; 
unsigned long interfaces: 

I TVersion; 

//Architecture (for example, pwpc 1 . l m681c F ) 

// Driver s creator lype (for example, AAPP} 

// Release number (for example, 0x0*180) 
ft Interfaces version (for example, 0x8480) 

typedef struct l 

short !OpCode: 

short iError; 

long IReserved; 

TVersion driver; 

TVersion reserved: 

J TPrVersion; 

U Must be kPrVersionOp 

U Iw reluming errors 
// Reserved, set to (1 
// Driver information 
ii Reserved, set to 0 


That's all youll need to do to support die new PrGeneral 
opcode in your driver — hard to believe, but true! 

What Application Developers Need to Know 

Although Apple doesn’t recommend that application 
developers check the wDev field of the print record, many do. 
They assume that the wDev value means 
they can count on certain features being present in 
the printer. For instance, many developers assume 
that a wDev of 3 means the printer driver supports PostScript™. In 


WDEV REGISTRATION 

Although from now on all printer drivers will be assigned a wDev 
ID of 255, we still request that you register your printer driver 
with Apple's Developer Support Center, to avoid creator type 
conflicts. To do so, register at http://www.devworld.apple,com/ 
dev/wdev, Here is the information you need to provide: 

* Company name and address 

* Contact name, phone number, and e-mail address 

* Make and model of device supported (for example, Apple 
LaserWriter 16/600) 

* Type of connection (for example, serial) 

* Creator type (for example, 'AAPL') 

You'll receive confirmation of your registration within five to ten 
working days. If you have questions about wDev registration, 
write to devsupport@apple.com. 


fact, it indicates only that the current primer uses the Apple 
LaserWriter driver. This leaves out the possibility' that a user has a 
non-Apple PostScript printer driver with an ID of, say, 243. 

Even though Apple doesn’t recommend that application 
developers rely on the wDev field (or the new PrGeneral opcode, 
for that matter), if you're going to change application behavior 
based on the number or creator returned, aL least do so properly 
so that your applications don't break with future releases of 
printer drivers. We recommend that you use the PrGeneral 
kPrVersionOp opcode, if available, to get the structure and then 
check the driver.creator and driver-release fields to determine 
the current printer driver and version (see Listing 1). You should 
also continue to support the old wDev method for printer drivers 
that have not yet updated to the new PrGeneral opcode. For your 
reference, the PrGeneral Version sample that accompanies this 
txilumn shows how to properly retrieve the version and wDev 
information. 

Go Forth and Print! 

As you can see, the changes dial printer driver and 
application developers need to make to support the new 
PrGeneral opcode are minimal. We’ve already adopted this new* 
method with the LaserWriter version 8.4,x drivers. We hope you 
will, too! BO 


RELATED READING* 

* " Print Hints: The All-New LaserWriter Driver Version 8.4" by 
Dave Polaschek, develop issue 27. 

• "Meet PrGeneral, the Trap that Makes the Most of the 
Printing Manager" by Pete "Luke" Alexander, develop Issue 3, 
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by Apple Developer Support Center 


Macintosh Q & A 


Q: When I used CopyBits to do a screen capture, the cursor 
isn’t included* W hy not? 


A: CopyBits calls ShieldCursor to hide die cursor before it does its 
work. That's why you never see the cursor in your screen 
capture. The following code hides the cursor and decrements 
die cursor count in the low-memory global to fool CopyBits not 
to call ShieldCursor. Standard warning; Using low-memory 
globals is dangerous and Is subject to future OS changes. 

unsigned charoldCrsrVls; 
short oldCrsrSiate; 

// Hide the cursor. 

oldCrsrVis - GetCrsrVisf) ; 

oldCrsrState = GetCrsrStateO ; 

SetCrsrVis((unsigned char) G): 

SerCrsrState(oldCrsrStst6 - 1); 

// Do the screen capture. 

CopyBits^.* *) 

// Restore the old cursor. 

SetCrerState(oldCtsrState); 

EetCrsrVia(oldCrsrVis); 

You should define the cursor functions as follows: 


g nun { 

CrsrVis = Dx SC C * // Cursor visible? [ byte | 

GrsrState - OxSDO // Cursor nesting kvd [word] 

1; 

void SetCrsrVis(unsigned char cursor-visible) 
( 

* (unsigned char^CrsrVis = cursoiVisible; 

J 

unsigned char GetGrsrVis(void) 

f 

return ( *(unsigned char*)CrsrVis }; 

) 

short GetCrsrState(void) 
i 

return ( *(unsigned char*)Cr^rState ); 

] 

void SetCrsrState(short val) 

\ 

* (unsigned chat*)CrsrState = val: 

1 


Q: How can 1 determine whether the cursor is hidden? 

A; Currently the best way to determine this is to use a low- 
memory global that has been removed from LowMem.h. The 
reason it has teen removed is that a future operating system 
may handle it differently. 

Using low-memory globals has never really been sanctioned, 
though they were documented in older interface files. The 
Universal Interfaces were designed to make way for future 
operating systems; access to some low-memory globals was 
provided through accessor functions for safety, white access to 
others w r as removed. 

The global you want, CrsrVLs, is a byte sized flag that tells 
whether the cursor is hidden. It was defined in an older 
interface file like this: 

enuoi t 

CrsrVis - GxSCC* // Cursor visible? [byte] 

]; 

You can simply check this global to sec if the cursor is hidden. 
As always, the direct use of low-memory globals is not 
recommended and w ill probably cause your code to break in 
the future, 

Q: I w ant to support dragging from my application to the 
Trash without having the Finder create a clipping file 
inside the Trash* 1 tried several options but they all 
failed. Is this possible? 

A: There is no good way to prevent a dipping file from being 
created in the Trash, or to prevent the “zoomback” animation 
that signals a failed drag. The problem is that the Finder treats 
the Trash like a folder; the drag succeeds or fails according to 
the user’s supposed intent w ith respect to a folder. 

In our opinion, however, this is good, since it s consistent w ith 
Lhe Trash metaphor. When the user drags an icon from a 
Finder window into the Trash, she expects the Trash to get fat 
so that she can later change her mind, open the Trash, and 
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drag the icon back out. Creating a dipping file in the Trash 
merely extends the metaphor. The only problem this might 
cause is that the user ought to fie able to reverse her decision 
and drag the clipping back into the application. If your 
application doesn't already support this action, you may have 
some work ahead. 

We realize that other applications manage to avoid making the 
Trash fat. This is, in our opinion, a Bad Tiling. A Hack. Wrong. 
Nevertheless, if you still feel you need to avoid making the 
Trash fat, it might be possible to do so. it would probably 
involve creating a file via flavorTypePromiseHFS, then 
deleting it before the Finder has a chance to make the Trash 
fat. Unfortunately, since this involves “fooling* the Finder, it 
isn't likely to work for future versions of the Finder even if it 
does work today . 

In short, this is not recommended. 

Q: When my application calls TrackDrag, it crashes in low 
memory at an illegal instruction* The Macs Bug stack 
crawl doesn't produce any useful information* Fvc 
stared and stared at my application's calls to the Drag 
Manager, and all the parameters appear to be valid* My 
drag tracking handler is never called, Incidentally* If 1 
take all calls to the Drag Manager out of my application, 
it runs just fine. I've been investigating this crash for 
two months* Why is life so cruel? 

A: YouVe unearthed a really ugly problem. The Drag Manager 
thinks the drag originated in the Finder, and makes some fatal 
assumptions based on that. 

Early versions of rhe Drag Manager did not enjoy the benefits 
of a drag-enabled Finder, so the Drag Manager plays a little fasl 
and loose with the Finder's jump table. Yes, that means what it 
sounds like: the Drag Manager calls die Finder routines 
through its jump table. 

The even more interesting story concerns the method by 
which die Drag Manager deckles that the current application is 
the Finder. When TrackDrag is called, the Drag Manager 
determines whether the drag originates in any of the windows 
in the window list of the current process. If not, the Drag 
Manager determines whether the drag originates in any Finder 
window. Since the desktop is a “window* for these purposes, 
there's a large area that qualifies. 

Once die Drag Manager has decided the drag originated in a 
Finder window, ii assumes that the Finder is the current process. 
(This is the fatal mistake.) Once this assumption is made, die nexL 
thing for the Drag Manager to do to coax die Finder into 
exhibiting the correct drag behavior is ail I an entry in whatever 
jump table can l>e found by offsetting die current value of 
register A5. This is valid if die Finder is the current process, but 


of course if the current process is your application instead, things 
go terribly astray: The Drag Manager calls a jump table entry in 
your application, thinking it's the Finder, and your application’s 
routine doesn't do the same diing that the Finder routine would. 
Any number of spectacular effects can result. 

“Now wait a minute," you're thinking, The drag originated in one 
of my application's windows; how is this said alxxit the Finder 
relevant?" The answer is in the event record you’re passing to 
TrackDrag. An event record is supposed to contain a where field 
expressed in global coordinates. However, die where field your 
application is passing is in local coordinates. How did liiis happen? 
Well, that depends on your application, but often it can result from 
an application frameworks (like PowerPoint, MacApp, or THINK 
Class Library ) modifying I he event record IxTore passing it to your 
code. There's no language-level way to specify that the record lias 
been modified, so the compiler doesn’t warn you, (Honesdy, diis 
is Not Your Fault.) 

Your code blithely calls TrackDrag with what it assumes is a 
valid event record but is nor. TrackDrag interprets the where 
field, which is actually in local coordinates, as global 
coordinates. This point is somewhere up and to the left of 
where your application expects, and quite often it’s in the 
desktop, which as we said alxwe is considered a Finder 
window for these purposes. The Drag Manager reacts by going 
through its ritual for drags originating in Finder windows and 
eventually crashes after calling some odd routine in your 
application, as described above. 

To solve this problem, simply call LocalToGIobal on the 
where field of the event record before calling TrackDrag. 

Q: When I drag from my application into a Finder window, 
the system crashes, I notice the Finder uses a 
windowKind value of 20 for its windows, and so does my 
application. When my application avoids windowKind 
20, everything's hunky-dory. What’s going on? 

A: Through the Drag Manager, the Finder has gotten access to the 
windows in your application's window list (specifically, by 
using undocumented calls to obtain the source window of a 
drag). If your window's windowKind field is 20 r the Finder 
assumes die window is one of its own (as opposed to a driver 
window, whose windowKind would t>e negative, or a dialog 
window, whose windowKind would 2, and so on). 'Hie 
Finder grabs the value in the window's refCon field and type¬ 
casts it to a pointer to a C++ object in the Finder’s heap. 1 think 
you can see where this is going: when the Finder attempts to 
dereference the pointer, many fascinating crashing behaviors 
can result 

The upshot of this Finder bug is that your application should 
not use windowKind values of 20. HO 
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by Apple Developer Technical Support Group 


Newton Q&A:Ask the Llama 


Q: I’m probably missing something obvious, but when I try 
to use an asynchronous output call in some situations, I 
get an exception, while synchronous calls seem to work 
fine. For instance, this code fails consistently with bus 
errors: 

endpoint:output{headerCache, 
nil, 

Usync: true, 
form: 1 string* 

completionScript: func(ep. options, result) 
self;SendDat&(endpoint * qfCursor)1); 

On the other hand, this code works fine: 

endpoint:output(headetCache, nil, nil); 

self:SendQata(endpoint, qfCur&ar); 

Fd really prefer to use asynchronous calls, but I keep 
running into problems. Do you have any suggestions? 

A: The key thing you're missing is that self (that is, the 
receiver) is not what you expect in your asynchronous 
callback. In your first example, you pass a completion 
frame as the third argument of the Output message. It's this 
frame that will be self (that is, that will be the context of 
the completionScript). This means that you send the 
sendData message to that completion frame. 

What you probably want is Lo send the message to the ep 
argument passed to the completionScript. This will be the 
endpoint to which you sent the Output message. In 
general, you will have scl Lhis endpoint to have a _parent 
slot that points to your application. Assuming that the 
sendData method is in either the endpoint or your 
application, you would modify the body of the 
completionScript to be 

ep:sendData{endpoint. qfCursot); 


The same restrictions apply for Input and Option calls as well 

Q: I have a pop up view that has an icon with some text, 
and I’d like the user to he able to edit the icon, I call 
MakeShape on the icon and draw r it into a bitmap. I 
then have an interface for the user to modify the icon. 
The problem occurs when I try to display the modified 
icon in the pop-up. It either doesn't show up, has 
incorrect hounds, or throws an exception. Before I 
modify the icon, it looks like something that would be 
returned by GetPictAsBits: 

[data: <bitn. Length 42>, hounds: 10*0,n.IS], I 

Once I call MakeShape on the icon, it looks like this; 

[class; bitmap, boundu: <houndsRocL, Length 8>, 
data: <pixels. Length bO* ] 

The pop-up chokes on this when I try to display it. First 
it threw an exception because it was expecting a frame 
instead of a binary object in the bounds frame. So I 
called SetBounds to set the bounds frame to (0,0,15451- 
Tliis enabled the pop-up to open, but the icon wasn't in 
the right place. Fiddling with the bounds frame didn't 
seem to help. So Tin guessing that the next problem is 
that I have pixels instead of bits in the data slot. I tried 
calling SetCIass on the slot to change it from pixels to 
bits. That actually didn't throw an exception, but the 
length is still different and it didn't look right. How can 
1 get my shape or bitmap back into a form that the pop¬ 
up will be happy with? 

A: i“he basic problem is that the binary object used by 
MakeShape to represent the picture (that is, <pixels, length 
54>) is not the same as that used in the bitmap structure 
(<bits, Length 42>). You have a couple of choices. Since the 
formats are documented, you can write some code to 


The llama is die unofficial mascot of the Developer Technical Support group in Apple’s Newton Systems Group. Send your Newton-related questions 
to dLllama@newton.appie.com. The first time we use a question from you, well send you a T-shirt. 
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convert the object returned by MakeShape into a 
NewtonScript bitmap object. The other option, which seems 
more complex but is probably easier to implement, is to use 
the MakeShape representation only for your icon editor. Let 
the user modify the MakeShape representation, bur keep 
track of the changes anti use them to modify the bitmap. So, 
while the user is editing the icon, there will be two data 
objects: the original icon representation using the bitmap 
data structure and the MakeShape representation that the 
user sees and modifies. As the user changes the MakeShape 
object, your code is also modifying the bitmap object. 

As a related side note, you can use DrawlntoBitmap to 
get the bits that represent the shape. 

Q: In an application I'm building. I want to keep a serial 
communication session open with a GPS unit 24 hours 
a day, unattended by the user. Both the MessagePad 
and the GPS unit are powered by the car. The GPS unit 
sends out data approximately every two seconds, fm 
using the “Basic Serial” Newton DTS sample code as the 
starting point. The communications code in the 
application works fine except that occasionally I get a 
-18003 exception, which results in a 
kMessage_BufferOverrun message. I’ve tried turning 
on useSoftFlowControl and useHardFlowControl in 
the kCMOlnputFlowControlParms parameter frame 
inside the MBuildConfigOptions method, but that 
doesn't seem to help. 

Can you explain when/why this exception is raised? 
Can I safely ignore the exception by revising the 
MNotify Error method? What can I do to prevent the 
occurrence of the exception in the first place? 

A: A -18003 error can indicate several drings, including bad 
parity or a framing error. Usually it indicates that the 
Newton’s UART C.SCC chip) buffer has overrun. You can just 
ignore this error, repos L the inpuL specification, and go on 
your merry way. 

To repost Lhe input specification, call the endpoint's 
SetlnputSpec with the relevant input specification. Before 
reposting the input specification, you may also warn to 
flush the communication took buffers using the serial 
discard data option (kCMGSemlBlscard) and flush the 
NewtonScript buffer with Flushlnput. Regardless of 
whether you flush, you will have lost some data in the 
process, although for most GPS applications that should be 
fine. You may also w^ant to try increasing the size of the 
serial input buffer; this might give you just enough Lime to 
process all the data. 


A better solution would be to have the GPS receiver 
support, some type of flow control, though this will depend 
on the manufacturer of the unit, 

Q: 1 have a view with a protoKeyboard button. The input 
lines within the view all take numeric input, and when 
the user double-taps, the numeric keypad pops up. But 
the keyboard button brings up the full QWERTY 
keyboard instead. How can I make the button open the 
numeric keypad? 

At The keyboard button is behaving correctly. If you don't 
specify which keyboard to open, it will always open the 
global alphanumeric keyboard. There are two ways you can 
get the behavior you want: 

■ Override the defauitKeyboard slot in your protoKeyboardButlon 
This slot contains the keyboard that you want to use. In this case 
you want the symbol ’numericKeyboard, which specifies the 
default numeric keyboard. 

• Override the buttonClickScript in the proto Keyboard Burton, 
You can use the OpenKeypadFor function and specify your 
input line as the view'. This will usually do the right thing 
since calling OpenKeypadFor has just about the same effect 
as the user’s double-tapping in an input line, 

Q: I noticed that the NTK project preferences dialog lets 
you compress your application. How much slower will 
the application run if 1 do this? 

A: Unfortunately, there’s no simple answer to this question. 
The speed of execution depends on a number of factors, 
including how many times the system has to uncompress 
pages from your application into a cache and how full the 
system heap is. 

The best way Lt> find out is to try your application wath the 
three different compression options; none, compressed, or 
faster compression. Make sure that you perform your Lests a 
number of limes and under different memory-loading 
conditions. If your application will 3>e doing communications* 
that’s a good thing to test. You can also use HeapShow 
(which comes with NTK) to fill the system and NewtonScript 
heaps to simulate low-memory conditions. El 
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arising from tlx use of any [woduct sold through Developer IX-pH. 'll it- limit of direct damages, if any, shall not exceed tlx purchase price dfihe nnxIiictCi 1997 X plain Corporation: All 
rights reserved, Any unaudv>riJ!ed duplication is in vktkilioTt of federal laws. Developer IX:|M is a registered trademark t*F Xplain fk mj>* ration Ail product names in this tatnbg are tlx 
E rat It rmti rks c if their respeeti ve holders. 
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For Macintosh 

Frogrammers & Developers 

Mdcfech 


MacTectT Magazine 

MacTech keeps Mac programmers & developers up to date with 
everything they need to know about software development. 
Topics like Rhapsody, Java. QuickTime, OPENSTEP, Objeclive-C, 
C/C++. Object Oriented Technologies, product reviews and 
much more! 

Subscriptions: 

(MTYRDM) US/Domeslic $47 tor 12 issues 

(MTYRCM) Canadian $59 for 12 issues 

(MTYRFM) International $97 for 12 issues 

Back issues: $10 each plus shipping (subject to availability) 





MacTech® Mouse Pad 

Slide on this! With an extra-large surface (11" by 10'') and a 
deluxe sleek plastic coating, you'll be zooming across your 
screen in no time at ail. Speed limit not enforced! 

(AMTPAO) Our Price $8.95 


MacTech® CD-ROM Volumes 1-12 

• Includes Apple's develop™ issues 1 -29 

• Almost 1600 articles from all 139 issues of MacTech 
Magazine (1984-1996) 

• Improved hypertext, improved indices, and a new THINK Reference 
Viewer—for lightning quick access! 

• New hyperlinks between articles 

• 1 00+ MB of source code—use them in your applications, with 
no royalties! 

• Full version of THINK Reference™—the original online guide to Inside 
Macintosh. Vols. I-VI 

• 80MB of FrameWorks/SFA archives and the most complete set of 
Frameworks archives known 

• Sprocket™! MacTech's tiny framework that compiles quickly and 
supports System 7.5 features 

• The best threads (rom the Macintosh programmer newsgroups plus 
thousands of notes, tips, snippets, and golchas 

• Popular tools that Macintosh programmers use to increase their 
productivity and much more! 

(SMTCD12) Volumes 1-12 Our Price $129 
(SMTCD12U) Upgrade Our Price $49 



(BBEST4) Our Price $4.99 


T lif Dcfinlrlvfl 

* MacTutor 


Best of MacTUtor 

The Best Of MacTutor Volume 4 
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System 7.5 Technologies 


by Apple Computer, Inc. 

• Self-paced course designed to allow software 


developers to write code that extends the 
functionality of an application for System 7.5. 

• Conlains comprehensive materials for drag-and- 
drop. threads, standard mail package, and QuickDraw GX printing. 

Students should he familiar with the basics of developing an 
application on the Macintosh. Metrowerks CodeWarrior Lite is 
included on the CD with the lab exercises. The lab assignments were 
developed in CodeWarrior 8. The labs can also be done in another 
development environment but project tiles for them are not provided. 



Apple Guide Integration 


by Apple Computer, Inc. 


• Self-paced overview teaches you when and 
how to add Apple Guide help to your program. 

♦ Powerful help system that can guide the 
user through a task. 

• Tutorial will lead you through the steps necessary to integrate 
Apple Guide into your application. CodeWarrior Lite is included on 
the CD with the lab exercises. 


Training Format: Tutorial with labs. 

Requirements: Macintosh or Mac-OS compatible computer with a 
68020 processor or greater (PowerPC preferred): 8 MB RAM: 25 
MB hard disk space; System 7.5 or later; CD-ROM drive. 

(SSYSTECH) Our Price $ 49.95 


Training Format: Overview with labs. 

Requirements: Macintosh or Mac-OS compatible computer with 
68020 processor or greater. PowerPC preferred; 8 MB RAM; 25 MB 
hard disk; System 7.5 or later; CD ROM drive. 

(SAGO Our Price $ 49.95 


Virtual liitor for QuickTime VR 


Q 



By Apple Computer, Inc. 


• Self-paced, hands-on course, which 
provides a comprehensive environment tor 
learning the steps of the QTVR 
development process. The student can 
cover all of the topics or choose areas to 
focus on. Topics covered include: QTVR 
capabilities and key concepts, panoramic 
movies, object movies, QTVR Scene 
movies and authoring with QTVR. 

• CD-ROM contains lots of useful examples 
and demos. In addition to all the step-by- 
step exercise tiles. 


If the student completes the entire course, 
he/she will create a complete, authored 
multimedia project similar to the 
demonstration title that comes on the 
enclosed CD-ROM. There are approximately 
3-4 days of training. 


Training Format: Tutorial with labs. 

Requirements: 40 MB RAM minimum. 64 
MB preferred; Macintosh or Mac OS- 
compatible computer with a 33 MHz 68040 
processoror greater; System 7.1 or later; 
CD- ROM drive; 17“ color monitor. 
(SVTFQTVR) Our Price $ 79.95 



Newton Programmer’s 
Guide for Newton 2.0 


AppleScript Software 
Development Toolkit 1.1 

• AppleScript language, system software 
extension, and script editor 

• FaceSpan 1.0 

• Developer’s redistribution license for 
AppleScript System software extension 
and FaceSpan runtime code 
(SASDT) Our Price $49 
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Newton 

Newton Toolkit 1.6 


k Apple Dylan 


The Newton Programmer's Guide consists 
of two volumes covering the Newton 
System Software, and one volume 
covering Newton Communications 
The Iwo-volume set, Newton Programmer’s 
Guide: System Software, is the definitive 
guide and reference for Newton 
programming. This set of volumes explains 
how to write Newton programs and 
describes the system software 
routines that you can use to do so 
The Newton Programmer’s Guide: 
Communications, describes the Newton 
communications system software for version 2.0 
(BNPGFN) Our Price $149 


Apple Dylan 
Technology Release 

• Contains a PowerPC-native prototype 
version of a development environment 
based on the Object Oriented Dynamic 
Language (OODL) Dylan. Developers will be 
able to produce code targeting both 680x0 
and Power Macintosh systems 

• Automatic memory management 

• Application framework and user-interface 
& builder 

• High-level exception handling 

• Cross-language support for C code and APIs 
CD & Online Documentation 

(SADTRO) Our Price $ 39.95 
CD & Hardcopy 

(SADTRH) Our Price $ 59.95 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 


f 


With Newton Toolkit, you can easily create 
software that runs on any Newton PDA. 
including Apple’s MessagePad and Motorola's 
Marco. 

• Now supports Newton 2.0 

• Dynamic Language Eases Development 

• Allows you develop applications interactively 

• New Compiler Enables Faster Applications 
Newton Toolkit 1.6 

(SNETO) Our Price $299 
Newton Toolkit Update 1.6 
(SNETOUP) Our Price $49 






APPLE PRODUCTS 














Apple Media Tool Programming Environment 2.0 

• This object-oriented language and application framework allows 
programmers to customize features used within the Apple Media 
Tool authoring environment 

• Includes an expanded Apple Media Language (AML) class library, 
incremental compiling and linking of AML code, faster debugging 
facilities, Macintosh Programmers’ Workshop (MPW), and user-oriented 
documentation written from an AMIPE developer's perspective 

• Portable across 68K, Power Macintosh, and Windows platforms 

(SAMTPE) Our Price $995 


Multimedia Authoring with Apple Media Tool 

by Apple Computer, Inc. 

Apple Media Toot offers new multimedia users a way to get started 
creating interactive multimedia with minimal learning time. This self- 
paced tutorial will make Apple Media Tool (AMT) even easier to 
understand and to use. Using this tutorial, you will create a realistic 
multimedia project using exciting techniques such as QuickTime movies, 
animation and more. A demo version of AMT is included and can be used 
for the exercises. Training Format: Tutorial with tabs. 

(SMWAMT) Our Price $49.95 



Virtual Reality 

Programming 

with QuickTime VR 2.0 

by Apple Computer, Inc. 

• Virtual Reality Programming Book/CD-ROM 
for QuickTime VR 2.0 

• Enables you to write C and C++ programs 
using QuickTime VR 2.0 

• Allows QuickTime VR to be used in 
games, multimedia titles and other 
programs 

• QuickTime VR 2.0 objects can be zoomed 
in on, panned, or linked with hots spots 

■ Both panoramas and objects have hot 
spots linked to World Wide Web URLs 
(SVRPOt) Our Price $49 


QuickTime VR 2.0 
Authoring Tools Suite 

by Apple Computer, Inc. 



QuickTime Developer’s Kit 2.0 

by Apple Computer, Inc. 

• QuickTime 2.0 Extension, QuickTime Power 
Macintosh Extension, and QuickTime 
Musical Instruments extension 

• Utilities like MoviePlayer 2.0,16-bit Audio 
Compression, etc. 

• Sample content such as MPEG Movies, 
Music Movies, 

Time Code Movies, and 60 field per 
second movies 

• Includes software-only playback features 
such as (aster 2x playback mode for 
current compressors, Apple Cinepak 
compressor, 1 -bit fast dithering, network 
tuning, load-into-RAM option, and Photo 
CD support 

(SQTDK) Our Price $99 


photographic, digital, video, or computer 
generated images 

• Included is a complete set of 
documentation for planning, designing, 
photographing, and creating QuickTime VR 
panoramas and objects. The authoring 
tools also allow you to link objects to 
panoramas using clickable hot spots 

Included on the CDs are: 

• A software tool (MPW-based) that stitches 
and blends adjacent images into a 
panoramic PICT file 

• A software tool (MPW-based) that dices 
and compresses panoramic PICT files to 
less than 100 KB (tow resolution) per 
panorama 



Object-Oriented 
Fundamentals 1.1 

by Apple Computer, Inc. 

• DU’s multimedia Object-Oriented 
Fundamentals course enables you to easily 
make the paradigm shift from procedural to 
object-oriented design. It will introduce you 
to the entire object skill set, from general 
concepts through analysis and design 

• This course includes a “lite" version of 
Metrowerks CodeWarrior integrated 
development environment for use in the 
labs. This course also includes a copy of 
the book Leam C++ on the Macintosh by 
Dave Mark 

(SOBORFU) Our Price $245 


• A scene editor (HyperCard-based) to 
create QuickTime VR scenes by adding 
and positioning nodes, hot spots, linking 
nodes together, and for linking QuickTime 
VR objects to scenes 

• A variety of utility tools for formatting the 
data into the 

runtime software 

Due to a revolutionary distortion-correcting 
algorithm, QuickTime VR panoramas and 
objects maintain a normal perspective when 
the user moves the mouse. The speed of the 
algorithm allows up to 24-bit color images. 
Both vertical and horizontal panning can 
occur at fast speeds. 

(SQTVRATS) Our Price $395 


• QuickTime VR is a cross-platform software 
from Apple which enables webpage 
designers and professional developers to 
create new multimedia products and 
webpages incorporating QuickTime VR 
content. With QuickTime VR. users 
interactively navigate through 360° views 
of space, and explore three dimensional 
objects on Macintosh or Windows-based 
personal computers 

• The QuickTime VR Authoring Tools Suite Is 
a set of Macintosh tools to create and link 
panoramas and objects from 
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AudioTrack 

by WAVES 

AudioTrack is a 
software plug-in for 
native processing on 
digital audio 
recording and 
editing systems. 
Waves AudioTrack combines the most- 
needed audio processors into a single 
piece of software, including 4 bands of 
equalization, compression/expansion, and 
noise gating. AudioTrack is ideal for 
preparing audio for InterNet streaming 
formats, processing individual 
mono/stereo tracks of audio and audio 
for video editing systems including digital 
sequencers. 


Feature list 

• A single window interface 

• 4-band ParaGraphs Equalizer, 
Compressor/Expander and Gate 

• instantaneous A/B comparisons of on 
line settings 

• Pretested setup libraries supplied for 
various processing solutions 

• Power Macintosh native processing 
{requiring no DSP board) 

• Volume and gain reduction meters 

• Peak hold and clip meters 

Requirements: 

The AudioTrack is compatible with ail 

machines supported by Deck II, 

SoundEdit 16, Adobe Premiere 4.0 and 

Cubase VST 3.1. 

(SAUDIOTRK) Our Price $270 



Order Toll-free 
800-MACDEV-1 


1800622-33811 
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Native PowerPack 

by WAVES 

Waves Native PowerPack - a 
complete pro audio system of Waves 
software that utilizes native 
processing within the computer, 
requiring no additional hardware. The 
Waves Native PowerPack is a 
complete effects processing solution 
for those making records, creating multimedia titles, authoring audio 
for the InterNet, designing sounds for games, or recording at home. 

The Native PowerPack is available on the Macintosh for Macromedia 
SoundEdit16 and Deck II, Adobe Premiere, Bias Peak, Steinberg 
Cubase VST and Digidesign Audiosuite, and on Windows95 and 
WindowsNT using Microsoft AcliveMovie architecture to support 
Sonic Foundry Sound Forge, Steinberg WaveLab, Twelve Tone 
Systems CakeWalk, and other platforms that are using Microsoft 
ActiveMovie architecture. 

Native Power Pack for Mac or PC includes: LI - Ultramaximizer peak 
limiter, 010 - Paragraphic EQ, Cl - Compressor/gate, SI - Stereo Imager, 
TrueVerb -virtual/space reverb, and WaveConvert - Batch converter. 
(SNPWRPCK) Our Price $600 


WaveConvert 

by waves 

WaveConvert is an easy to use cross- 
platform audio processing application 
for multimedia developers. It“s ideal for 
all multimedia audio productions, 
delivering loud and clear audio files. It 
combines the well-known peak limiting 
technology of the Waves LI 
Ultramaximizer with other Waves processors into a powerful audio 
processing tool which offers one step conversion of multiple files. 

• Sample rate conversions from 5kHz to 48kHz 

• Audio level normalization 

• Preview function 

• Stereo/mono conversion 

• Tone and gain control 

• Reduced background noise 

• 16/8 bit conversion using special audio maximization techniques 

• Preparation for RealAudio 

• AIFF, “.snd", .wav, SOU. and RAW formats 
(SWAVECON) Our Price $270 





Clip VR ,M 

by eVox Productions 

Clip VR “ is a new digital image library 
offering high quality Photographic Virtual 
Reality (PVR) images for use with Quicktime*’ 
VR and other desktop VR tools. 


Clip VR " Panoramic Image components include 
alpha channel masks. Combine elements into a 
composite panorama which is converted to 
the ftnislted Quicklime VR movie using Make 
QTVR Panorama Tool. The Components 
("Clips'') include complete 360 degree 
scenes, libraries of 360 degree terrains, 360 
degree skies, buildings, and objects. Images 
are provided as .PICT files AND Quicklime VR 


movie files. Clip VR™ allows you to create 
high quality VR worlds from pre¬ 
photographed component images. Clip VR™ 
can be used to add excitement to a web site, 
to increase the interactive value of a CD- 
ROM, or simply for fun! Requires imaging 
editing program such as Adobe Photoshop" 
to perform PICT image compositing. 
(SCLIPVR) Our Price $89.95 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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Hyperprism-PPC Real-Time 
Sound Effects Processing Software 



Hyperprism-PPC 1.2 is highly flexible and creative effects processing 
software tor the PowerMac, tts unique Blue Window™ interface 
allows for dynamic, on-the-fly, “analog-like" gestural control over 
multiple effects processing parameters simultaneously. 

• 24 high quality real-time processing algorithms 

• Non-destructive, dynamic, multipass processing 

• Presets provide ready-to use settings for instant results 

• No additional audio hardware is required 

• I/O is also possible with 3rd party sound cards 

• Supports mono/stereo Sound Designer ll/AIFF files, 8/16 bits at 
standard sample rates 

Requirements: Power Macintosh or Mac OS-compatible with 
PowerPC processor: 8 Mb RAM; 1 Mb HD space: System 7.1 or 
later: Sound Manager 3.1 or later recommended. 

(SHYPERPPC) Our Price $380 

Hyperprism-MMP (Multi Media Producer) 
Real-Time Sound Effects Processing 
Software 

by Arboretum Systems 

Hyperprism-MMP 1.06 is a package of highly flexible and creative 
effects processing plug-ins for applications supporting the Adobe 
Premiere plug-in architecture. 

Requirements: Power Macintosh or Mac OS-compatible with 
PowerPC processor; Adobe Premiere-compatible host application; 
3mb RAM; Imb HD space; System 7.1 nr later; Sound Manager 3.1 
or later recommended. 

(SHYPERMMP) Our Price $300 

Hyperprism-TDM Real-Time Sound Effects 
Processing Software 

by Arboretum Systems 

Real-time sound effects processing software dedicated to the 
Digidesign TOM NuBus platlorm. Hyperprism TDM is considered as 
the only set of Plug-Ins on the market to cover most ot the needs of 
professional recording studios and post production houses.ce. 
(SHYPERTDM) Our Price $945 


Hyperprism-68K Real-Time Sound Effects 
Processing Software 

by Arboretum Systems 

Hyperprism is a real-time sound effects processing software for 
Audio Media l&ll, Sound Tools l&ll, or Pro Tools 442 NuBus systems. 
It takes full advantage of the 56K DSP {Digital Signal Processor) that 
resides on these audio cards and works great on faster Macs such 
as Quadras. 

Requirements: Any Macintosh running System 7.0 or higher with 
NuBus slots and either a Sound Tool l&ll, or Audio Media l&ll, or Pro 
Tools 442 systems; 8 Mb of Ram; 6 Mb of HD space. 

(SHYPER68K) Our Price $389 


Ionizer Real-Time Dynamic Spectral 
Reshaping Tool 

by Arboretum Systems 

Ionizer is a real-time 512-band 
gated equalizer and multiband 
dynamics processor. Typical 
applications for Ionizer include 
broadband noise reduction, 
audio restoration and repair, 
mastering, multimedia, 
broadcasting, sound design, special effects, and anywhere you need 
powerful EQ and dynamics control. 

Requirements: Power Macintosh or Mac OS-compatible with 
PowerPC processor; 8 Mb RAM; 8 Mb HD space; System 7.1 or 
later: Sound Manager 3.2.1 or later recommended. 

(SiONiZER) Our Price $800 



Captivate 4.6: 

Essential Graphics 
Utilities 

by Mainstay 

Captivate™ 4.6 is a powerful collection 
of graphics utilities for Macintosh, based 
on Mainstay’s acclaimed screen capture 
nedia scrapbook, and graphics viewer. 

Captivate provides essential graphics utilities to the professional 

and hobbyist alike. 

• Package includes: Captivate Select, Captivate View, and 
Captivate Store 

• Any one of the three can be used alone, and together they 
make an unbeatable team 

• Whether writing a training manual, creating an ad, or just 
creating a startup screen from your favorite picture, Captivate is 
everything professionals need at a price anyone can afford. 
(SCAPTIV) Our Price $79 
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CodeWarrior Gold 12 

» by Metrowerks 

Here’s what's new in CodeWarrior 12 

• New improved IDE version 2.0 

• Support of Apple's New 
Rhapsody Operating System 

• Hybrid C++/0bject C Compiler 
Allow developers to begin 
creating applications that will run 
on the Rhapsody OS. Start 
building the next generation 
applications today. 

• Threaded Execution 
You no longer have to tie your 

up during compilation, you can browse code and even 
edit projects and files while you are compiling. Less downtime. 

• Multiprocessor Compilation 

If you are using a multiprocessor machine, the CodeWarrior IDE 
allows you to utilize this additional power and speed, cutting your 
compile times. Less waiting, more productivity. 


• New Toolbars 

Most windows and toolbars are now customizable to suit the 
preterences of developers. Tailor the environment to the way 
you work. 

• New MacOS Merge Linker 

The new CodeWarrior tools include a new tinker that can merge 
MacOS 68K and PowerPC executables into one application. 

Now you can distribute both versions Mac customers need with 
less hassle. 

• Improved Drag and Drop Integration 

With the new CodeWarrior IDE, it is now easier to add files and 
folders to a project simply by dragging and dropping. Quicker 
navigation, easier to use. 

• Version Control Integration 

CodeWarrior 12 comes with a plugin that allows full integration 
of Microsoft SourceSafe right from the Metrowerks’ IDE. This 
allows SourceSafe users full version control for managing large 
software projects. 

(SCWGOLD) Our Price $399 



• Start programming for the new, innovative Be Operating 
System (BeOS) with complete set of Codewarrior tools 


• BeOS-native Integrated Development Environment (IDE) with 
all the familiar CodeWarrior features at your fingertips 

• A BeOS PowerPC compiler and linker, an editor w/syntax 
color and styling, and a source-level debugger 

• BeOS header and libraries, complete documentation, useful 
C++ classes, and sample code 

• The Be Operating System DR8.2 tor Power Macintosh allows 
you to run and program tor the BeOS on a 603 or 604 PCI 
based PowerMac 

(SCWFB) Our Price $149 

Web site: http://www.devdepot.com 


CodeWarrior Wear (xl only) 

You live it, you breath it... you might as well wear it! 

• Black CodeWarrior Sweatshirt: 

(ACWSWEAT) Our Price $ 29.95 

• "Blood, Sweat & Code” black short-sleeve shirt: 
(ACWSBLOOD) Our Price $ 9.95 

• Hawaii Five-0 shirt: 

(ACWHAWAii) Our Price $ 7.95 

• Hat: Please Specify: Black (ACWBHAT) or White (ACWWBHAT) 
Our Price $ 14.95 

• Winter Hat (see Web site) (AWINHAT) Our Price $ 14.95 


CodeManager 

by Metrowerks 



Source code control system, plug¬ 
in to the CodeWarrior IDE 
Compatible with Microsoft Visual 
SourceSafe version 4.0a 
Cross-platform support (Mac, 

Windows, UNIX, OS/2) 

Configuration management in excess of 4 billion files 
Over 8,000 flies and sub-projects in a single sub-project 
Registered users receive one year of free technical support and 
two free updates 

Includes a 1-year MacTech subscription. 


(SCDMGR) Our Price $399 


Order lel-free 
800-MACDEV-l 


[800622-3381 j 
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DEVELOPMENT ENVlll 



Order Toll-free 
800-MACDEV-1 


IBOM22-33BH 


Roaster 

by Roaster Technologies, tnc. 

Roaster Release 3 is now available and shipping! Get the most out of 
Sun's Java™ programming language with this powerful 
development environment. 

• Features include: ability to build completely stand-alone Macintosh 
applications or applets; visual interface builder; ability to create 
cross-platform zip files; powerful Java debugger; wizard for quickly 
creating Java applets or applications; JDBC included; Java object 
database included; ability to call AppleScripts from Java; Just-in- 
time (JIT) compiler; JDK 1.0,2 support; class tree and hierarchical 
class browser; much more! 

• Software includes; Over 300 example applets and applications; 
Netscape Internet Foundation Classes; Object Design's PSE for 
Java; OpenLink Software’s JDBC Drivers; OpenSpace Java Generic 
Library; Microline Component Toolkit Lite 3,0; much more! 

• Requirements; Runs on 68k or PowerPC, CD-ROM 
■ Price includes all web-based updates 
(SR0AST3) Our Price $99 



THE DEVELOPMENT 

ENVJFtONVIEMT FOR JAVA 
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Symantec Visual Cafe 

by Symantec Corporation 

Symantec Visual Cafe for Macintosh or Windows gives developers 
the fastest, most productive visual programming environment ever 
for creating Java applets and applications 

• Drag and drop visual programming, easy to learn and use 

• Flexibie development environment, two-way programming 

• Comprehensive component library, create re-usable templates 
■ Extensive Java toolset and the fastest compilers 

(SVCAFEMAC) Our Price $199 
(SVCAFEWIN) Our Price $199 


TM 


SYMANTEC, 



LS Fortran Pro 

by Fortner Research LLC 

LS Fortran Pro is an ANSI standard Fortran 
77 compiler with extensions for Fortran 90, 
VAX, Cray, Data General, and MS PC 
Fortran, The package includes both the 68K 
and Power Macintosh versions of the 
compiler for MPW, as well as Power 
Macintosh versions for use in Metrowerk’s 
Codewarrior or Symantec Project Manager. 


» Easy to use and produces robust 
optimized code, wide range of 
extensions, porting code from mainframe 
computers is effortless. 

• Supports the Macintosh toolbox, provides a 
full-feature Macintosh output window and 
offers simple commands for adding a 
Macintosh user Interface. 

• Also included: Math77, a library of 
mathematical subroutines for the 
computational analysis of scientific data; 
Source Code Analyzer, a powerful static 
analyzer that is extremely useful in 
successfully porting large applications, 
and for debugging programs with 
extensive use of Macintosh toolbox calls; 
and the HDF Libraries, standard data 
format libraries for effecient storage of 
many types of ascientific data. 

(SLSFORT) Our Price $595 



LS Fortran Plug-In 

by Fortner Research LLC 

Codewarrior owners can now experience 
the power of Fortran. The LS Fortran Plug- 
In for Codewarrior and Symantec Project 
Manager, allows programmers to write 
and compile Fortran programs in the 
popular, easy-to-use GUI environment, 
and effortlessly [ink Fortran with C and 
Pascal code, 

(SLSFPi) Our Price $199 
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Check out our Web site! 

• Full product descriptions ■ Hundreds of more products 

http://www.devdepot.com 


F77 SDK 

by Absoft Corporation 

For Power Macintosh includes a globaily optimizing native compiler 
and linker,native Fx™ multi-language debugger and Apple's MPW 
development environment. 

• The compiler is a full ANSI/ISO FORTRAN 77 implementation 

• Includes all MIL-STD 1753 extensions, Cray/Sun-style POINTER, 
and several FORTRAN 90 enhancements 

• MRWE, Absoft 1 s framework library is included in the MIG 
graphic library 

• Supports the native Macintosh PRC toolbox 

• includes Absoft's Fx debugger which can debug intermixed 
FORTRAN 77, C, C++, and PPC assembler 

• The linker compiler, and debugger ail run as native PPC tools, anti 
produce Macintosh PPC executables 

(SF77) Our Price $589 


Pro Fortran 

by Absoft Corporation 

Absoft Pro Fortran combines native F90, VAX compatible F77, and 
C/C++ compilers into a single, easy to use environment. All compilers 
are link compatible and operate through a common interface. 

• Graphical debugger, browsers, array display, performance profiler, 
linker, MRWE application mainframe 

• MIG graphics library, Absoft Create Make, several utilities, the 
latest version of MPW and illustrated documentation 

• Whole array operations, modules, interface blocks, and user- 
defined types or data structures 

• Dynamic memory allocation and new control constructs 

• F90 is link compatible with Absoft F77, C++, MrC and 
CodeWarrior 

• It is fully compatible with Toolbox, MPW tools, and most third- 
party products 

(SAPROF) Our Price $899 


VIP-BASIC™: 

Visual Interactive 
Programming in BASIC 

by Mainstay 

Now you can create full-featured, 
stand-alone Macintosh and Power 
Macintosti applications in standard 
BASIC code! VIP-BASIC 2.0 is the 
fastest way to program your Macintosh. 

• Rapid application development environment with application 
framework, mix and match: VIP-BASIC high-level subprograms 

• Intelligent dispatcher/resource editors and prewritten toolbox calls 
standard BASIC libraries and powerful visual debugger 

• Import pre-existing BASIC code: automatically integrate BASIC 
code, export C Code for compiling: automatically convert your 
BASIC code to C for compilation with Metrowerks’ CodeWarrior. 

• Includes full-featured mini database: (ltd to 32K) of the powerful 
VIP-BASIC database manager gives you everything you need to 
setup royalty-free, multi-user database applications. 

(SVIPBASIC) Our Price $195 


Macintosh Common Lisp 4.0 

by Digitool, Inc. 

Macintosh Common Lisp provides users with 
a rich set of object-oriented dynamic 
language features making it especially well- 
suited for rapid prototyping, custom 
development for business and education, scientific and engineering 
applications, and academic research 

• Power PC native environment & compiler, full Macintosh support 




(•I 


VIP-C™: 

Visual Interactive 
Programming in C 

by Mainstay 


Now you can create full-featured, 
stand-alone Macintosh and Power 
Macintosh applications in just minutes, 
V1P C 2.0 is the first rapid application 
development system for creating complete Macintosh programs in 
standard ANSI C. 


• Rapid application development environment: create full-featured 
Macintosh apps, includes application framework: set up a 
bulletproof main event loop and routines plus all VIP-C source code! 

• Intelligent dispatcher/resource editors and pre written toolbox calls 

• Reduce complexity in Mac programming with high-level function 
libraries mix and match: VIP-C high-level functions, standard C 
libraries, and Mac toolbox calls 

• Includes powerful, tightly integrated visual debugger, Import pre¬ 
existing C code; automatically integrate C code with a current project. 

• Includes full-featured mini database; (ltd to 32K) of the powerful 
VIP-BASIC database manager gives you everything you need to 
setup royalty-free, multi-user database applications. 

(SVIPC) Our Price $295 


• CLOS, the standard Common Lisp object system 

• Interactive dynamic environment, multiple processes 

• Automatic memory management and self-typing data 

• Ephemeral garbage collector, smaller application footprint 

• Compiles with Common Lisp industry standard and smart 
programmable tools, 110+ mb of user contributed code 

• Complete on-line documentation (manual sold separately) 

• Software license and registration card 
(SMCLISP) Our Price $675 
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Memory Mine 

by Adianta Inc. 

• Monitor heaps, identify 
problems such as 
memory leaks, 
and stress 
test applications 

• Active status of 
memory in a heap is 
sampled on the fiy: 
allocation in nonrelocatable (Ptr). relocatable (Handle) and free 
space is shown, as are heap corruption, fragmentation, and more 

• Allocate. Purge, Compact, and Zap memory lets users stress test 
all or part of a program 

(SMEMMINE) Our Price $99 


Water's Edge Software 



Tools Plus libraries + framework 

by Water’s Edge Software 

Easily create compact, fast running, professional looking applications and 
plug-ins*. Tools Plus lets you create virtually any user interface element 
with a single routine, and it transparently provides a robust infrastructure 
to make all your pieces work together as an application. Rated 4 stars by 
Macworld! 

MacTech (July 96): “it’s an incredibly rich collection ot tools... If you are 
interested in developing applications that have ’quality' written all over 
them, then Tools Pius is for you,” 

• Simplifies programming and thins source code 

• Automates all standard GUI elements 

• Thousands of extras, from floating palettes and tool bars to 
powerful picture buttons 


NS BASIC 3.6 
for the 
Newton with 
Visual Designer 

by NS BASIC Corporation 

• A fully interactive implementation of BASIC programming language 

• Runs entirely on the Newton - no host is required 

• Create files, access the built-in soups, and the serial port to 
input and output 

• Work directly on the Newton, or through a connected Mac/PC and keyboari 

• Get the BASIC Internet Tool, available at no charge to NS BASIC user: 
from www.nsbasic.com. 

• Release Notes with sample code are available from the same location 

• Runs on any Newton MessagePad 130 with NS BASIC and the Newtoi 
Internet Enabler. Also runs on MP 1201s with NOS 2.0 that have fu 
memory available 

• Write short programs to access News, mail and the web 
(SNSBASIC) Our Price $99 


• Includes numerous 30 grayscale options 

• Over 1/2 MB of custom fonts, icons, cursors, and other resources 

• Includes SuperCDEFs world-class controls (an $89 value) free 
(STOOLCWG) Our Price $249 

CodeWarrior Gold (C/C++ & Pascal, 68K & PPG) 

(STOOLCWB) Our Price $199 
CodeWarrior Bronze (C/C++ & Pascal. 68K) 

(STOOLSYMT) Our Price $199 

Symantec (THINK) C/C++ and THINK Pascal (68K) 

(STOOLSYM) Our Price $149 Symantec (THINK) C/C++ (68K) 
(STOOLPAS) Our Price $149 THINK Pascal (68K) 
‘CodeWarrior required to write plug-ins 







WAI* , 

TK® re *i Here’s a list of ail available products. For full product descriptions 

M°' e! 

PRODUCT 

Discover Programming for Mac 
Discover Programming With Java 
LPA MacProlog Developers Edition 
LPA MacProlog Programmers Edition 
Mac FORTRAN II 
Power MachTen-UNlX 
Presenting Magic Cap 
SmalltaikAgents 
Symantec C++ for 68k 
Symantec C++ 8.5 
Think Pascal 4.0 


CODE 

OUR PRICE 

SCWDISCMAC 

79.00 

SCWDiSCJAVA 

79.00 

SLPAD 

995.00 

SLPAP 

495.00 

SF0RT2 

595.00 

SM10PPC 

695.00 

BPRESMAGIC 

15.25 

SSTA 

695.00 

SSYMCPP68K 

99.00 

SSYMCPP 

399.00 

SPASCAL 

165.00 
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Symantec Visual Cafe 

by Symantec Corporation 

Symantec Visual Cafe for Macintosh or Windows gives developers the 
fastest, most productive visual programming environment ever for 
creating Java applets and applications 

• Drag and drop visual programming, easy to learn and use 

• Flexible development environment, two-way programming 

• Comprehensive component library, create re-usable templates 

• Extensive Java toolset and the fastest compilers 
(SVCAFEMAC) Our Price $199 
(SVCAFEWIN) Our Price $199 


OOFILE Reporter Writer 

by A.O. Software 

• Full embedded report-writer, allows you to preview page-by-page 
and either print or save as plain text, HTML or RTF 

• Multiple levels of breaks, database views, headers and footers are 
provided using a clean object-oriented design 

• Incudes RAM-based version of OORLE database. Included in full 
OOFILE Platform Bundle 

• Saving to file without preview of printing Is cross-platform-run on 
your Mac/Win/Unix server and creates 

web pages 

• Price includes 1 -year subscription 
(SOORW) Our Price $500 


Check out our Web site! 

• Full product descriptions * Hundreds of more products 

http://www.deudepot.com 



PageCharmer 1.0 

by Mainstay 

PageCharmer is a set of customizable interactive applets that 
enhance web pages without writing a single line of HTML code. 
Whether the web site is already up and running or designing one 
from scratch, PageCharmer gives you the power to make it stand 
out from the crowd with sophisticated applets that can be 
personalized to fit most any need. 


FEATURES: 

LiveG-Map, LiveT-Map, LiveG-Button, LiveT-Button, LiveGT-Button, 
LiveG-Ticker, LiveT-Ticker, LiveG-Marquee, and LiveT Marquee. 
(SPGCHRM) Our Price $ 139.95 


ObjectSet Mail SDK 

by Smartcode Software 

• Powerful C++ classes for 
integrating internet e-mail in 
your applications 

• Helps you write software that 
can share mail with other leading 
e-mail products 

• Royalty-free MIME, SMTP, and 
POP3 APIs for Macintosh, 

Windows, and Unix 

• Gives you the most robust MIME parser and encoder available 

• Ideal for use in Internet and Intranet environments 

• Comes complete with samples with documented, reusable 
source code 

• Free standard technical support 
(SOSMSDK) Our Price $495 




BBEdit 4.0 

by Bare Bones Software 

A powerful, easy-to-leam text editor, Adds 
new features for HTML coders, including a 
spelling checker and HTML tag palette, 
Accelerated for Power Macintosh; dragging 
supported everywhere; Internet Config 
aware; PowerTalk aware. Integrated support 
for Symantec’s IDE, Metrowerks 


CodeWarrior, THINK Reference 2.x, MPW 
ToolServer, and most other environments 
Many UNIX style tools, including "grep" 
searches, file comparisons, and sorting 
multi-file search and replace. 
PopUpFuncs feature lets you jump to a 
function from a menu. 

(SB8ED1T) Our Price $119 
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FaceSpan v2.1 

by Digital Technology International 

•Develop integrated software, make stand 
alone applications, create friendly 
interfaces 

•Develop quick prototypes, print multiple 
pages with sophisticated layouts 

•Script essential elements of the FaceSpan 
application - Enhanced save options 


• Play and record sounds as either “snd” resources or as “AIFF" files 

• Create miniature or complete apps that run on either Power PC or 
68k computers 

• Use precise time measurement for implementing timed behaviors 
- New properties 

• Proportionally scale PICT images -Align images in a pictbox - 
Automate any application 

• Monitor and respond to low-memory situations-Increased support 
for Frontier UserTalk! 

(SFACESPAN) Our Price $299 


TCP/IP Scripting Addition 

by Mango Tree Software 

• Award-winning AppleScript scripting 
addition 

• Allows you to write scripts using 
MacTCP™ commands in AppleScript™ 

• Send e-mail or files through a script, 
check if users are logged on (via Finger). 

automate FTP. Gopher. NetNews, Telnet, and LPR. verify links in 
HTML documents, and quickly write many other TCP/IP client- 
server programs 

• Works with AppleScript. MacTCP 2.0.4 and Open Transport 
(STCP) Our Price $49 

WindowScript 

by Royal Software, Inc. 

WindowScript is the ultimate tool for designing Macintosh user 
interfaces using HyperCard. Design Real "Macintosh” user-interfaces 
right inside HyperCard. Until now you either created HyperCard 
stacks or Macintosh applications. With WindowScript you can literally 
bring the look and feel of a real Macintosh user-interface to 
HyperCard. If you're a HyperCard developer, interface designer, 
application developer, program manager or tester searching for a 
prototyping tool, WindowScript is perfect for the job. 

(SWSCRIPT) Our Price $149 


V .- 


TCP/IP 

Scripting Addition 

The Aurcrnrt SaftMtei 


Script Debugger 

by Late Night Software Ltd. 

• A powerful and flexible AppleScript 
authoring tool - get the most from 
AppleScript! 

• Advanced debugging environment offers 
single-step script execution with 
breakpoints 

• Script Debugger dictionary browser 
features a graphical view of objects provided by scriptable 
applications 

• Includes Late Night Software Scripting Additions - a collection of 
more than 70 new AppleScript commands, and Scheduler, a utility 
that allows you to launch scripts at pre-determined times 
(SDEBUG) Our Price $129 

Scripter 2.0 

by Main Event Software 

For professionals, for novices, for 
webmasters, for solutions providers, there's 
only one serious choice. Scripter! 

• Scripter and FaceSpan work together; one 
click opens your FaceSpan script in 
Scripter, another sends it back 

• Debug handlers without modifying your scripts using the Call Box 

• Applet simulation, live editing. Object map, associated terminology 

• Search backwards, block generators, more navigation shortcuts, 
more drad-and-drop, and an even more enhanced trace log 

• ScriptBase is now included; stores your data and media elements 
(frequently used values, text, pictures, scripts, HTML, headers, file 
references) and share them between scripts all with a special 
new browser 

• Easily write and compile scripts that have handler declarations 
and other vocabulary specific to a particular scriptable application 

• Scripter is the natural companion to AppleScript for users at all 
levels of proficiency. Don't write scripts without ft! 

(SSCRIPTER) Our Price $199 

AppleScript Finder 
Guide, English Dialect 

by Apple Computer, Inc. 

Provides definitions for Ffnder object classes and commands. Write, 

record, or run scripts that trigger the same desktop actions that you 

trigger using the keyboard and mouse. 

(BAFG) Our Price $ 17.95 





Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 


PRODUCT 


CODE OUR PRICE 


DogPatch 
PreFab Player 
ScriptBase 

Tenon Ported Applications CD 


SDOGPATCH 

SPLAYER 

SSCPTBASE 

SPORTED 


199.00 

95.00 

59.00 

50.00 
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Legtop Podeum 

by Rach Inc. 

A combination working 
platform and carrying case 
that allows laptop owners a 
safe and comfortable way 
to use their computer in a variety 
of mobile and field environments. 
• Straps to your leg for mobility! 
(ALGTPPOD) Our Price $ 79.95 



CronManager 

by Orchard Software 

• Implements the UNIX Cron facility 


• Open any Macintosh file on a given date and time 

• Simple interface 

• Works with any Macintosh file 

• Cron Manager bundled with CUmate 
(SCRONMGR) Our Price $ 26.95 


CPU Doubler 

by Orchard Software 

• Performance enhancement 
utility for the Macintosh 

• Increases the speed of 
your computer by 100% 

• Works on both the PowerPC 
and 68K Macintosh 

• Manages computer 


CPU Doublet 
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* 

tug OrturdMwir*, h *1 * | 3 

Doubling Options 

Q Efcst Psrform#ncf 

0 BPtrfftrrosnct 

O Good PwHsf 

® Curiam Ptrfarmaw 

[ Edit Protests*.., \ 

+95 

iHtfp./] t 

KaM 4 #vh , 

raCED 

■ 

n£OS 

□ LisJ 

il iftrlvp 
t. il»rt 

spaclul settings 
f EKtlude FUSl... 1 

O Exctufc aackqrouttf-ttftly 

Qtaltrie Finder 


throughput using a proprietary scheduling algorithm 
Ensure optimal performance and compatibility 

(SCPU2X) Our Price $ 79.95 

SEE RELATED PRODUCTS: Development Environments 


NeoAccess 

by Neologic 

• Full-featured object database engine tor use in Macintosh. 
Windows, Unix and DOS based C++ applications 

• Extended binary trees and binary search algorithms tuned for 
short access times; dynamically combined, collapsed, and 
compressed indices; object caching for instant access to 
previously used objects 

• Build fast, powerful applications in record time! 

(SNEO) Our Price $749 


Check out our Web site! 

• Full product descriptions • Hundreds of more products 

http://www.devdepot.com 


c-tree Plus® Database Handler 

by Faircom 


Unsurpassed 
Crass Platform 
Tools for Mac 
Developers! 

• Full C Source 

• Client/Server 
Option 



• Over 16 years proven reliability 

• Concurrent simultaneous access of Mac/PC files 

• Superior throughput and performance 

• Unparalleled scalability and flexibility 

• Fixed/Variable length files 
(SCTPDH) Our Price $895 


r-tree Report Generator 

by Faircom 

Handles virtually every aspect of 
report generation; 

• Complete C source 

• Complex multi-line reports 

• Multi-file access 

• Complete layout control 

• Conditional page breaks 

• Nested Headers and Footers 

• Horizontal Repeats 
(SRTRG) Our Price $445 



Cr°^ e \oP , S'j9 


Guide Composer" 

by StepUp Software 


1.2 


STEP UP 

SOFTWARE 


Create powerful Apple Guide help systems for any new or existing 
Macintosh application 

■ Provides a WYSIWYG development environment; Guide content is 
developed in Guide windows 

■ Design topics, phrases, and panels in the same format as the user 
will use them 

■ Features are WYSIWYG interface, Topics, phrases, and 
hierarchical phrases, Coach marks, Fully-Integrated with Apple’s 
Guide Maker (distributed with Guide Composer), 

compiles scripts automatically, PICTs in Panels, Generated Guide 
scripts are modifiable 

1 FREE Update to ail registered Guide Composer users, Demo is 
available at http://www.guidewoiks.com/ 

(SGCOMP) Our Price $99 

SEE RELATED PRODUCTS: AppleGuide Complete, Danny Goodman's 
AppleGuide Starter Kit, Real World AppleGuide 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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VOODOO 1.8 

by UNI SOFTWARE PLUS 

• Smooth integration with Metrowerks CodeWarrior IDE 

• Support of AppleEvents and AppleScript 

• Comparison of flies of different types (not only text flies) 

• Configurable local file locking (Finder flag or ckid resource) 

• Improve handling of local files includeing the creation of folder 
structures 

• Significant performance improvements in many places 

• Essential parts PowerPC native 

• Version control tool for die simple and clear management of 
projects in which tiles 

are created in numerous versions (variants and revisions) 

• Allows both variant and revision control, and it manages not only 
variants and revsions of single files, but of a whole software 
project (multi flies, multi users, multi-variants, access rights, etc.) 

• Graphical user interface and is not oniy suitable for mere source 
code control but can handle all different kinds of files with amazing 
compression rates: typical size of delta between arbitrary files 5% 

• Please note special prices for multiple copies: 

Single license (SVOODOOI) $ 229 ; 2 pack (SV00D002) $ 359 ; 

5 pack (SV00D005) $ 799 ; 10 pack (SVOODOOI 0) $ 1369 ; 

20 pack (SV0000020) $2399 
Additional pricing available on request. 

SEE RELATED CATEGORY: Dev. Environments 


StoneTable 68K/PPC 

by StoneTablet Publishing 

• StoneTable is a replacement for the Macintosh List Manager 

• Available for use with Think C. MPW C & Pascal, CodeWarrior C 
and Pascal 

• Includes libraries tor 68K and PowerPC 

• An LTable-like class is provided to incorporate StoneTable into 
the PowerPlant environment 

(SSTONEFAT) Our Price $200 


QC 

by Onyx Technology 

High performance runtime stress testing for applications. 

• Tests include heap checks, purges, scrambles, handle/pointer 
validation, dispose/release checks, write to zero, de-reference 
zero as well as other tests like free memory invalidation and 
block bounds checking 

• Extremely user friendly - ideal for non-programmer testers 

• Also available in Japanese 
(SOC) Our price $99 


Compilelt! 

by Royal Software, Inc. 

Compilelt!, Ihe first HyperTalk compiler, is a complete developement 
system for the creation of XCMDs and XFCNs. 

• Expand the capabilities of your environment by using Compilelt! 
and the ROM Toolbox extensions 

• Increase the speed of routines written in HyperTalk by turning 
scripts intooexternals 

• Protect sensative code from prying eyes because your code is 
now compiled! 

• Easily learn Macintosh programming by exploring the ROM Toolbox 

• Includes Debuglt!, a valuable source-level debugger for externals 
created with Compilelt! 

(SCOMPIT) Our Price $149 


MacA&D 6.0 

by Excel Software 

MacA&D combines the capabilities o! MacAnalyst plus additional 
detailed design, code generation and code browsing features into 
one integrated application. It automates structured analysis and 
design, object-oriented analysis and design, state modeling, task 
design, data and screen modeling, code editing and browsing, 
reengineering, requirement traceability and a 
multi-user data dictionary. It generates SQL from data models, C++ 
or Object 

Pascal from class diagrams and C, Pascal, Basic or Fortran code 
from 

structure charts. 

• Structured analysis and design 

• Object-oriented analysis and design 

• Real-time and multi-task design 

• Data and screen modeling 

• Integrated code editing and browsing 

• Multi-user dictionary and requirements 

• Code to design diagrams for C, C++, etc, 

• Design diagrams to code for C, C++, etc. 

• State modeling diagrams and tables 

• Use cases with traceability 
(SMACADP) OurPrice $1995 


Apprentice 6 

by Celestin Company 



Apprentice 6 is a high-quality CD ROM collection of over 600 
megabytes of up-to date source code, utilities, and info for Mac 
programmers. All of the source code and utilities are completely 
new or updated for this release. 

• Frontier 4.1, Ihe highly-acclaimed scripting environment 

• More PowerPlant AND many more PowerPC samples 

• Cool new languages and environments added (Clean, Eittel, F, 
Tcl-Tk) 

• Hot new demos from leading Mac development companies 
(SAPPRENT6) OurPrice $35 
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SoftPolish CD-ROM 

by Bare Bones Software 

* Ttie essential too[ for software quality assurance on the Macintosh 

* Helps you identify inconsistencies with Apple's user interface guidelines, 
misspelled words, missing resources, and other mistakes 

* Provides tools to put the finishing touches on software distribution 
packages prior to release 

* Works independently of any programming language or environment 

* Ideal for sanity checking software throughout the development process 
(SSOFTPOL) Our price $99 


Spellswell Plus 2.1 

by Working Software 

• Award-winning, comprehensive, practical spelling checker that 
works in batch mode or within applications that incorporate the 
Apple Events Word Services protocol (e.g., Eudora, WordPerfect, 
Communicate!, and InfoDepot) 

• Checks tor spelling errors as well as common typos like 
capitalization errors, spaces before punctuation, double word 
errors, abbreviation errors, a/an before vowel/consonant, etc, 

• Mac Tech orders include developer kit with Writeswell Jr., a sample 
AppleEvents Word Services word-processor and its source code 

• Available for OEM Sales 
(SSPELL) Our Price $ 49.95 


B-ltee HELPER 2.2 

by Magreeable Software 

■ Inexpensive database engine 
for Macintosh programmers 
in C source code 

• Uses contiguous fixed length 
blocks 

• Expands the file as necessary and contracts fiies when 
possible 

• Inserts and deletes keys in one or more B-Trees 

• Finds keys equal to, less than, or greater than a given value 
in a few hundredths of a second 

• Finds lists of records whose keys are equal to, less than, or 
greater than a given value or are in a range of values 

(SBTREE) Our Price $150 



Future Basic!! 

by Staz Software 

FutureBASIC II is the award winning 
leader in Macintosh BASIC 
programming, 

• Source level debugger and Interactive compiler/editor 

• Multi-file Project manager and Multi-file find and replace 

• Super fast compilation, 32 bit clean, and System 7.x savvy 

• QuickBASIC converter 

• Getting Started manual with over 500 example files 

• Full support of standard BASIC 
(SFBASIC2) Our Price $229 



• True relational database system for Apple Macintosh computers 

• Provides a powerful choice for developers who want to create 
database centered applications with no performance trade-offs 

• Features SQL, full transaction control, error recovery, single user, 
client sewer architecture and multi-platform support including 
DOS, Windows, OS/2 and UNIX 

• The C/C++ API is identical and fully portable across all supported 
platforms 

• Third-party vendors supporting dtF will be able to otter a variety of 
advanced features and benefits to their customers royalty free 

• Tools are included for importing, exporting, creating and managing 
databases and users 

• Supported development environments include: Symantec, MPW, 
Metrowerks and more Mac/SOK 

(SDTF) Our Price $695 



Step-Up Installer Pack 

by StepUp Software 

• Package of several Installer "atoms" that let developers incorporate 
graphics, sounds, file compression and custom folder icons into 
Installation scripts 

• Compression formats supported are Compact Pro & Diamond 

• Each atom also available separately 

• Compression requires additional licensing 
(INSTALL) Our Price $219 


ScriptGen Pro 

by StepUp Software 

• Installer script generator which requires no programming or 
knowledge of Rez 

• Supports StepUp’s InstallerPack, Stufflt decompression, Compact 
Pro decompression, custom packages, splash screens, network 
installs, and resource installation 

(SSCRPTGEN) Our Price $169 
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Testfrack-Bug fracking the Macintosh Way 

by Seapine Software, Inc. 

• Tracks bugs, feature requests, test configurations, users, and more 

• Includes notifications, security, a powerful filter mechanism, and 
multiple reports 

• Links your testers, engineers, documentations staff, and project 
managers together to ensure all bugs are identified, fixed, and 
documented 

• Eliminates the need to build custom bug tracking solutions using 
general purpose database tools 

• Supports single- and multi-user bug databases (additional licenses 
required to use multi-user features) 

(STETR) Our Price $129 



MacFlow™: Flowchart 
Design and Development 

by Mainstay 

Use MacFiow™ 4.0 for Macintosh to 
produce top-quality diagrams fast, 
without tedious drawing. Present your 
company's organizational structure or 
design and document the flow of a manufacturing process. Develop 
any overall view of work, project, or logic flow in just minutes! No 
other flowcharting method offers the ease-of-use, speed, and 
outstanding flexibility of MacFlow tor Macintosh. 


• Create Quality Flowchads — Fast 

• Intelligent Symbols Make Flowcharting — Easy 

• Turn Outlines Into Flowcharts — Automatically 

• Customize Line and Arrowhead Styles 

• Expand Functionality Using Plug-In Modules 

• Link Nested Charts, Comments, and Files 

• Share Charts Electronically — royalty-free! 
(SMACFLO) Our Price $179 


AppMaker 

by Bowers Development 

• Develop the user interlace for a 
Macintosh application using the 
original interface builder 

• Just point and click to design your 
application 

• Creates resources and generates 
excellent source code 

• Supports most development 
environments including Metroweiks, Symantec, or MPW; C, C++, 
or Pascal: procedural or object-oriented, using PowerPlant, TCL, or 
MacApp 

• The generated code uses the Universal Headers to provide 
PowerMac compatibility 

• Great tool for beginners to learn object-oriented and Macintosh 
Toolbox programming techniques 

• Includes one-year subscription on CD and hardcopy documentation 

$299 


Plan & Track ": Project 
Planning and 
Management 

by Mainstay 

Plan & Track™ 3.5, for Macintosh helps 
you plan and manage any project. With 
Plan & Track, you can create a project plan minutes after opening 
the package. There's no taster or easier way to keep things on track 
and within budget than with Plan & Track. 

• Direct Approach to Project Planning: Quickly plan projects, events, 
and campaigns 

• Create Presentation-Quality Project Plans: Quality, lull-color 
charts or layouts, Integrated Spreadsheet and Graphing 

• Automatic Calendar Management: Plan & Track automatically 
creates and manages, Multiple-Page Schedules 

• Earned Value Analysis: Offers a simple method of relating value, 
cost, and progress 

• Drag-and-Drop Support, Standard and User-Defined Symbols 
and Task Bar Styles 

(SPLNTRK) Our Price $179 


(SAPPMAKE) Our Price 




Phyla™: Object-Oriented Database 

• Powerful Databases Without Programming: Phyla handles your all your complex database needs 

’ • Define a Database in Minutes; Using an intuitive, graphical user interface 

jH I * 0lj jects Arc a More Natural Approach: Phyla creates real world databases 

• Drag-and-Drop Ease: Relate objects by simply dragging objects between windows 

1WJ9 • Create Custom Forms and Reports: Quickly create custom forms and reports 

. p ast Finds and Sorts: Perform complex queries and calculations without programming 

• Synchronize Multiple Databases Copies 
-• Password Protection With Access Limitations 

• Easy Impori and Export; Import from other databases, export data in various formats 
(SPHYLA) Our Price $179 
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VText 

by Vivistar 

VText is a C++ add-on library for 
Metrowerks' PowerPlarit 
application framework. VText 
provides complete Macintosh text 
support including; greater than 
32kb text, undo, drag and drop 
editing, AppleEvent scripting and 
recordability, full support for 
multibyte characters and inline 
input methods including Japanese 
and Chinese text, arid full support for bi-directional script systems 
including Arabic and Hebrew. 

• Full featured text engine for Metrowerks' PowerPlant 

• Stylesets and rulersets with tabs 

• Flexible object oriented C++ API 

• Full undo and drag and drop editing 

• WorldScripl savvy including bidirectional and multibyte scripts with 
inline editing 

• AppleEvent factored tor scriptability and recordability 
(SVTEXT) Our Price $350 



LiveAccess™ 1 User Edition 

by dtF Americas 

Suite of OpenDoc™ parts for accessing relational database 
systems. 

• Compatible with FileMaker Pro, 4th Dimension, 0rac!e7 and ODBC 
(SLAUE) Our Price $69 

LiveAccess™ 1 Developer Edition 

by dtF Americas 

Suite of OpenDoc™ parts for accessing relational database systems 

• Includes the User Edition plus IDL-fites to extend the LiveAccess 
parts suite 

• Compatible with FileMaker Pro, 4th Dimension, Oracle7 and ODBC 
(SLADE) Our Price $99 


OpenGL for 
the Macintosh 

by Conix Graphics 

• Powerful 3D graphics library, 100% OpenGI compliant 

• Portable to more platforms than any other API 

• Delivers workstation-class performance to the Mac 

• RAVE hardware support gives you the speed you need 

• Multi-processor capability & works with ALL compilers 
(SOPENGL) Our Price $279 




DesignWorks 4.0 

by Capitano Computing 

DesignWorks 4.0 has aii the ease of use and schematic editing power 
of previous versions, pius new features designed to make your entire 
design process easier and more error free, the 4,0 version has new 
mcnucustomization and scripting features that will directly address 
your designchecking and interfacing needs. 

• Flexible schematic editing features speed the drawing process 

• Full Undo/Redo on all editing operations 

• Hierarchical design with unlimited levels is fully supported 

• Powerful attribute features allow arbitrary text information lo be 
associated with any signal, device or device pin 

■ Extensive symbol libraries with over 12,000 parts in ANSI and IEEE 
format 

■ Integrated device symbol editor allows you to create custom 
symbols using standard drawing tools 

• Interactive digital simulator option is available. No netllsts, no 
application switching! 

(SDWORKS) Our Price $995 



CGi Toolkit 

by Preforms Inc. 

The Pictorius CGi Toolkit is the fast and easy 
route to high performance CGIs and ACGIs for 
your Mac Web site. 

•Interactively develop CGIs while the web 
server, the CGI Toolkit and the browser are 
running on me same machine 
Interactively develop, test and debug CGIs before compiling 
Powerful debugger allows you to edit code, roll back, code and 
change input values while your application is running 
Fully object oriented so you can re-use your code 
Automatic handling of Apple Events so you can concentrate 
on building functionality 

Easy creation of multi-function CGIs which reduces application 
footprint and RAM usage 
(SCGITUO) Our Price $149 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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QUED/M 3.0 

by Nisus Software 



• The programmer's text editor that 
defined the industry standard for 
speed and efficiency 

• PowerPC native 

• Features integrated support for 
Symantec C/C++, Metrowerks 
CodeWamor 6, and MPW 

• Supports all the major development environments on the Macintosh. 

• Powerful editing features, including unlimited undo and redo, macro 
language, scripting, text folding, ten editable/appendable clipboards, 
markers, displaying text as ASCII codes, dynamic coloring of C/C++ 
keywords/comments, rectangular and non-contiguous selection 

• Includes Celestin Company’s APPRENTICE 4 
(SQUEDM) Our Price $89 


Check out our Web site! 

Full product descriptions • Hundreds of more products 

http://www.devdepot.com 




Bee-one 

by Power Box 

Bee-one lightens your load on the road by 
adapting relational databases developed 
under 40“ to the Newton Platform. Once 
[he program is installed on both the 
Macintosh and the Newton, it takes 4 
simple steps to use Bee-one! 

• Database transfer, Set-up, Use, and 
Synchronization 

(SBEEONE) Our Price $ 139.95 
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There * Here are more products. For full product descriptions please see our Web 

_- orC ! site, or feel free to call, fax, or E-mail us. 



** PRODUCT 

CODE 

OUR PRICE 


Animation Class library 

SACL 

250.00 


CLImate 

SCL1MATE 

59.95 


CMaster 

SCMASTER 

129.95 


DataScript 

SDSCRIPT 

230.00 


ICONIX PowerTools-10 Pack 

SICPP10 

7,845.00 


ICONIX PowerTools-6 Pack 

SICPP6 

5,945.00 


ICONIX PowerTools-8 Pack 

SICPP8 

6,945.00 


ICONIX PowerTools-AdaFlow 

SICADA 

1,395.00 


ICONIX PowerTools-ASCII Bridge 

SICASCI! 

1,395.00 


ICONIX PowerTools-CoCoPro 

SICCOCO 

1,395.00 


ICONIX PowerTools-DataModeler 

SICDATAMOD 

1,395.00 


ICONIX PowerTools-FastTask 

SICFASTTASK 

1,395.00 


ICONIX PowerTools-FreeFlow 

SICFREEFL 

1,395.00 


ICONIX PowerTools-Object Modeler 

SICOBJMOD 

1,395.00 


ICONIX PowerTools-PowerPDL 

SICPOWER 

1,395.00 


ICONIX PowerTools-QuickChart 

SICQUICKCH 

1,395.00 


ICONIX PowerTools-SmartChart 

SICSMART 

1,395.00 


ICONIX Training & Consulting 

TICONIX 

2,945.00 


IMSL Math and Stat Library 

SIMSLSTAT 

495.00 


Info-Mac X 

SINF0MAC10 

39.95 


U Profiler 

SUPROF 

295.00 


Mac Source II 

SMACSOURCE 

29.95 


MacA&D 6.0 

SMACADP 

1,995.00 


MachTen Code Builder 

SM10C0DEB 

149.00 


Macintosh Common LISP 4.0 

SMCLiSP 

675.00 


Spellswefl Plus 2.1 

SSPELL 

49.95 


Spyer 

SSPY 

39.00 
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Casino! 

by BeachWare, Inc. 

Can't make It to Vegas this month? Your 
best bet is Casino! Whether your favorite is 
Slots, Poker, Blackjack, or Kero, this virtual 
casino will entertain you for hours with its 
ten different machines, Mac System 
requirements: Color Mac, CD-ROM drive, 4 MB of RAM, PC system 
requirements: Windows 3,1 or later, CD-ROM drive, 4 MB ot RAM. 

(SCAS) Our Price $24.95 


Classic Arcade 

by BeachWare, Inc. 

Ten of your favorite coin-arcade games, 
redone with killer graphics and sounds! Walk 
through a virtual arcade and test your game 
playing skills with these exciting arcade 
classics. Ten games, including Moon Lander, 
Astro-Boing, Hyper Hockey, Ballistic Avenger, and more. System 
Requirements: Mac - Color Mac with 8 MB RAM, CD-ROM drive, PC 
- 486 with 8 MB RAM, Sound card, SuperVGA,CD-ROM drive. 

(SCLA) Our Price $29.95 



muiitsKy 

Night Sky Interactive 


EKTmiTlIE 

P) 

by BeachWare, Inc. 

Introducing a new PC/Mac introductory astronomy 

■;i®r m 5- 

• ■ , i i n 

tjr 

■w: g 

learning experience on CD-ROM. Constellations, 

■ < 

7-»-+»rr» 

comets, stars, planets, meteors, galaxies, the moon 


and more are yours to explore in this CD, Watch 



animations and hear narratives about how the moon 

-i - 


orbits the earth and many other topics. Mac System requirements; 
Color Mac, CD-ROM drive, 4 MB of RAM. PC system requirements: 
Windows 3.1 or later, CD-ROM drive, 4 MB RAM. 

(SNSI) Our Price $24.95 


MultiWare 

Multimedia Collection 

by BeachWare, Inc. 

Introducing a new Audio multimedia music 
CD-ROM for the Macintosh. This disc is a 
collection of clips ideal for Desktop 


collection of license-free media clips is bursting with 240+ color 
pictures and backdrops (PICT). 200+ sound & music clips (SoundEdit), 
140+ QuickTime movies, and a variety of multimedia tools for use with 
the Macintosh. 


(SMWMC) Our Price $24.95 
SEE REtATED CATEGORY; Multimedia 



1000 Games for 
Macintosh 

by BeachWare, Inc. 

The best Macintosh game disc in the 
entire world, this CD-ROM contains over 
one thousand great shareware and 
public domain programs. Battle ugly aliens, blast apart run-away 
asteroids, deal yourself that royal flush or solve that 3-D puzzle, this 
disc has it all! System requirements: Mac Plus or greater, CO-ROM 
drive, and 2 MB of available RAM (4 MB of RAM when running under 
System 7). 

(STGM) Our Price $17.95 


A Zillion Sounds 

by BeachWare, Inc. 

An incredible PC and Macintosh sound effects 
CD-ROM containing 2,177 separate sound 
effects and short music clips. Each sound is 
conveniently stored in both SoundEdit and 
System 7 Beep Sound formats for Macintosh and WAV format for 
Microsoft Windows. All of the sounds are conveniently organized in 
separate categories. Mac System requirements: Any Mac, CD-ROM 
drive, 1 MB of RAM. PC system requirements: Windows 3.1 or later, 
CD-ROM drive, sound card. 

(SAZS) Our Price $24.95 



Multimedia Nursery Rhymes 

by BeachWare, Inc. 

Introducing a magical new PC/Mac playing and 
(earning experience on CD-ROM. This disc 
contains forty Nursery Rhymes, ten of which 
include on-screen fingerplays! Each rhyme has its 
own screen with original artwork, wonderful 
animation, fun sound effects, and great songs. Mac System 
requirements: Color Mac, CD-ROM drive, 4 MB of RAM. PC system 
requirements: Windows 3.1 or later, CD-ROM drive, 4 MB of RAM. 

(SMNR) Our Price $24.95 


Goldilocks Gamebook 

by BeachWare, Inc. 

Introducing a beautifully illustrated & 
animated, interactive version of the 
classic Goldilocks and the Three Bears 
story, This PC and Macintosh CD-ROM 
presents the Goldilocks story in over 30 
interactive screens. Throughout the story you can also choose to 
play one of the seventeen separate games that relate to specific 
scenes and encounters. 

(SGGB) Our Price $24.95 




Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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Check out our Web site! 

Full product descriptions • Hundreds of more products 

http://www.devdepot.com 



Music Itacks 

by BeaciiWare, Inc. 

A new PC/Mac & Audio multimedia music 
CD-ROM. The clips include musical 
introductions, fanfares, background music, 
and more. This collection offers you 100 
music clips stored in WAV format for 
Windows, SoundEdit & AiFF formats for Macintosh and as Audio 
tracks for audio CS players. All ot the music clips are completely 
license and royalty-free!! Mac System requirements: Mac Plus or 
greater, CD-ROM drive. PC system requirements: Windows 3.1 or 
later, Sound Blaster compatible board, CD-ROM drive. 

(SMT) Our Price $ 24.95 




Trivia Warehouse 2000 

by BeachWare, Inc. 

Introducing a fun new PC and Mac CD- 
ROM. This disc contains two thousand trivia 
questions, in 45 categories, in several 
game formats! Test your memory with the 

_ O&A, Concentration, and Multiple Choice 

games! Categories include: Animals, 

Bodies, Bond, Bugs, Cities, Comics, Geography, Gilligan, Gross, 
Health, Holidays. Horrors. Kids, Knot's Landing, Math. Movies, and 
many more. Mac System requirements: Color Mac, CD-ROM drive, 4 
MB of RAM. PC system requirements: Windows 3.t or later, CD- 
ROM drive, 4 MB of RAM. 

(STW2K) Our Price $ 24.95 



Screen Machine 

MACHINE 

Personalize your computer screen L 

jjjjjfji 

with this dynamic and useful collection ot 


Screensavers and Wallpapers. Choose from 


over 100 original Screensavers such as 


flying airplanes, bouncing coffee cups, 


falling climbing gear, shifting psychedelic patterns, or floating 
spaceships. Customize your computer desktop with over 150 exciting 
new wallpapers such as sand, rocks, cloth, coins, cartoons, or 
unique patterns. Included Is an easy to use browser program that 
lets you sample all of the Screensavers and Wallpapers before 
installing them on your computer. 

(SSM) Our Price $ 24.95 


Web Ware 

by BeachWare, Inc. 

The ultimate collection of clip media and 
templates for building your own Web Page. 
An incredible selection of Shockwave 
movies, animated GIFs, buttons, bullets, 
dividers, and sample HTML pages. There 
are literally thousands of graphical elements on this disc, all there to 
spice up your web page. In all, it's about 300 megabytes of 
creativity only a mouse-click away! System Requirements: PC - 486 
or better with 8 MB RAM , Sound card. SuperVGA, CD-ROM drive. 
Macintosh - Color Mac with 8 MB RAM, CD-ROM drive. 

(SWEBW) Our Price $ 24.95 



Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 


PRODUCT 

CODE 

OUR PRICE 

3D Game Machine 

S3DGAME 

$299.00 

Digital Swimsuit Portfolio 

SDSP 

24.95 

Do It Youself Credit Repair 

SCR 

24.95 

Nature Photos 

SNP 

24.95 

Photo Textures 

SPT 

24.95 

Religion Bookshelf 

SRB 

24.95 

Vitamin 

SVITAMIN 

24.95 

World War II Almanac 

SWW2A 

24.95 
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INSIDE MACINTOSH 


by Apple Computer* Irv 



Inside Macintosh: CD-ROM 

by Apple Computer, Inc. 

More than 25 volumes in electronic form. Includes: QuickDraw™ GX 
Library, Macintosh Human Interface Guidelines, PowerPC System 
Software, Macintosh Toolbox Essentials and More Macintosh Toolbox. 
QuickTime and QuickTime Components. Access over 16,000 pages of 
information with Hypertext linking and extensive cross referencing. 
(BlMCD) Our Price $89.95 
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»S Here are all of the inside Macintosh products - 10 % off! For full product 
descriptions please see our Web site, or feel free to call, fax, or E-mail us. 


PRODUCT 

CODE 

OUR PRICE 

Inside Macintosh: AOCE Applications Interface 

BIMAOCE 

$40.45 

Inside Macintosh: AOCE Service Module 

BIMAOCES 

26.95 

Inside Macintosh: Devices 

BIMDEV 

26.95 

Inside Macintosh: Files 

BIMFIL 

26.95 

Inside Macintosh: Imaging with QuickDraw 

BIMIMAG 

29.65 

Inside Macintosh: Interapplication Communications 

BIMIAPP 

33.25 

inside Macintosh: Macintosh Toolbox Essentials 

BIMTBOX 

35.95 

Inside Macintosh: Memory 

BIMMEM 

22.45 

Inside Macintosh: More Macintosh Toolbox 

BIMMAC 

31.45 

Inside Macintosh: Networking 

BIMNET 

26.95 

Inside Macintosh: Operating System Utilities 

BIMOPSU 

26.05 

Inside Macintosh: Overview 

BIMOVER 

22.45 

Inside Macintosh: PowerPC Numerics 

BIMPPCNUM 

26.05 

Inside Macintosh: PowerPC System Software 

BIMPPCSYS 

22.45 

Inside Macintosh: Processes 

BIMPROC 

20.65 

Inside Macintosh: QuickDraw GX Environ, & Utilities 

BIMGXENV 

28.75 

Inside Macintosh: QuickDraw GX Graphics 

BIMGXGR 

28.75 

Inside Macintosh: QuickDraw GX Objects 

BIMGXOBJ 

28.75 

Inside Macintosh: QuickDraw GX Printing 

BIMGXPRNT 

26.95 

Inside Macintosh: QuickDraw GX Printing Extensions 

BIMGXEXT 

26.95 

Inside Macintosh: QuickDraw GX Prog. Overview 

BIMGXOV 

22.45 

Inside Macintosh: QuickDraw GX Typography 

BIMGXTYP 

26.95 

Inside Macintosh: QuickTime 

BIMQT 

26.95 

Inside Macintosh: QuickTime Components 

BIMQTCOM 

31.45 

Inside Macintosh: Sound 

BIMSOUND 

26.95 

Inside Macintosh; Text 

BIMTEXT 

35.95 

Inside Macintosh: X-Reference 

BIMXREF 

17.95 


(Book sale prices are contingent upon availability) 



Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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Danny Goodman’s Apple 
Guide Starter Kit 

by Danny Goodman 
and Jeremy Joan Hewes 

Create your own Apple Guide databases quickly 
and easily, without having to leam a scripting 
language, write coded files, or use several 
different files and programs. Includes advice 
and tips on how to design a good Guide, from planning and creation 
through testing, revising, and indexing. Book/disk, 320 pages. 
(BDGAGSK) Our Price $31.46 



a Apple Guide] AppleGuide Complete 

__ Complete 





by Apple Computer, Inc. 

Covers Guide Maker, the 
software you use to build | 
and test guide files. %w „ 

Learn about the complete 
cycle of designing as well as advanced 
topics such as scripting and coding guide 



files. Book/CD-ROM, 544 pages. 

(BAPLGD) Our Price $35.96 

SEE RELATED CATEGORY: Tools, Libs & Utilities 


Essential OpenDoc 

by Jesse Feiler and Anthony Meadow 

Gives an in-depth look at the technical issues of OpenDoc. Explores 
the three core technologies that support it's functionality - SOM, 
OpenDoc’s storage mechanism, and the Open Scripting Architecture 
(OSA), Also examines CyberDog, a set of OpenDoc part editors that 
provides access to Internet services and offers compelling example 
of the power of OpenDoc development. 

(BESOD) Our Price $35.95 


Mac OS 8 Revealed 

by Tony Francis 

The first authoritative look at this exciting 
new operating system. A must for Mac 
developers who want to make their 
software compatible with Mac OS 8. 

Essential for system administrators who 
plan to upgrade their system. Included 
CO-ROM contains demos of new Mac OS 8 features. 
(BMAC0S8R) Our Price $31.45 



R^Edit 

Complete 


ResEdit Complete, 

Second Edition 

by Peter Alley 
and Carolyn Strange 

Customize every aspect of your interface 
form creating screen backgrounds and icons 
to customizing menus and dialog boxes. 
Book/disk package, 608 pages. 

(8RESED2) Our Price $31.45 


OpenDoc Programmer’s Guide 

by Apple Computer, Inc. 

The official reference for the implementation of OpenDoc on the Mac 
OS. Describes the component software revolution and explains how to 
develop for it on the Mac OS platform Accompanying CD-ROM 
contains a complete reference to the OpenDoc programming 
interface, and an extensive collection of tested, reusable sample code. 
(BOPENDOC) Our Price $40.46 




OpenDoc Programmer’s Cookbook 

by Apple Computer, Inc. 

Shows you how to create OpenDoc software 
components, called parts editors, for the Mac OS 
Platform. Including instructions for setting up the 
Macintosh Programmers Workshop (MPW) 
development environment to write OpenDoc 
software. Annotated listings ot explaining the 
methods that implement the SamplePart part 
editor. Descriptions of other sample part editors created by the 
OpenDoc engineering team to illustrate more advanced features. An 
Introduction to toe System Object Model (SOM) technology 
underlying OpenDoc. 

(BODCOOK) Our Price $22.45 



The ResEdit All Night Diner 

by David Ciskowski 

An idea-fiiied menu and introduction to the joys of customizing 
software. Add personality to toe Mac by customizing default icons, 
the text ot menus and dialog boxes, cursors, pointers and more. Disk 
features ResEdit, plus lots ol sample resources. 

(BRESDINE) Our Price $22.45 
SEE RELATED CATEGORY: Dev. Environments 



WAiT* # 

There* 

Mere* 


Here are some popular books for those wanting to learn more about NEXTSTEP 


PRODUCT 

NEXTSTEP Development Tools & Techniques 
NEXTSTEP General Reference 
NEXTSTEP Programming Interface Summary 
NEXTSTEP User Interface Guidelines 


CODE 

BNEXTDTT 

BNEXTGR 

BNEXTPIS 

BNEXTUIG 


OUR PRICE 

$27.85 

40.45 
27.85 

22.45 
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PowerPC 

PowerPC Programmer’s 

Toolkit 

OPTIMIZING 

Programmer’s 

Toolkit 

by Tom Thompson 

CD-ROM includes a special version of 

CODE 

TH« 

nsn-iirc? pn lh>1 

Metrowerks CodeWarrior 7.0 and sample 

j, 

Ijltf-h F l'ct**rPII 

code from the book. Details how to write 

PowerPC applications in native code for 

1 .. ^ 


blazing speed. Written by art Apple insider. 


(SPPCPT) Our Price $40.50 


Optimizing PowerPC Code: 
Programming the PowerPC 
in Assembly Language 

by Gary Kacmarcik 

Take full advantage of the potential of the 
PowerPC by mastering the Assembly 
Language techniques. Learn to produce 
faster more robust software! 

(BOPTPPC) Our Price $35.96 


Network Frontiers Bundle 

byAP PROFESSIONAL 

Includes 3 books: 

Complete Guide to MAC,Backup Management, Designing AppleTalk 
Network Architectures, and Managing AppleShare and Workgroup 
Servers Apple Certified. Each bundle includes the first 3 books that 
correspond to the Apple Certified Server Engineer (ACSE) program. 
(BNETFB) Our Price $59.95 



Tog on Software Design 

by Bruce “Tog” Tognazzini 

Respected industry futurist, Tog, presents his 
vision of our technological future, detailing 
the steps computer professionals need to 
take to deliver new technologies that will 
profil the industry and benefit society in 
general. Contains Tog’s insights on a wide 
range of topics from quality management to 
the meaning of standards. 

(BTOG) Our Price $26.95 



Matin toth Frognmm' 


Programmer’s Toolbox 


TOOL 

BOX! 







Assistant CD-ROM 

Instant electronic access to 
Inside Macintosh essentials, 
by Addison-Wesley Publishing 

Get quick access to reference pages for over 

_ 4,000 Toolbox calls in your system software 

from their development environment. Essential 
information for Macintosh software developers. Hypertext links allow 
programmers to view related topics easily. The ultimate electronic 
reference tool for Macintosh programmers. 

(STBASST) Our Price $89.95 




A Fragment of 
Your Imagination 

by Joe Zobkiw 

Packed with useful code fragments for 
the Macintosh and Power Macintosh. 

Hard to find information about techniques 
used to structure and build fat, safe fat, 
and accelerated code resources. All code 
is reusable and is provided on the disc, 
along with Metrowerks Code Warrior Lite. Book/CD-ROM, 528 pages. 
(BFRAG) Our Price $35.96 


Macintosh Programming Secrets 2 nd edition 

by Scott Knaster and Keith Rollin 

Macintosh Programming Secrets is divided in two parts 
Part 1: "Concepts and Ideas." Discusses the evolution of the 
Macintosh and the standards, customs, and software that shape the 
system as well as the Macintosh user interface. 

Part 2: "Technical Adventures." Presents the skeleton of an 
application, and then builds upon that framework to describe how to; 
Create fancy dialogue boxes. Utilize the new 32 bit QuickDraw 
developments. Track the mouse with “marching ants”. 

(BPSECRET) Our Price $28.76 



BASIC for the Newton 

by John Schettino & Liz O’Hara 

Program on Macintosh, Windows-based PC, or on 
the Newton itself. Straight-forward "programming by 
example" approach you'll be writing Newton programs right away, 
Includes 3.5“ disk containing Demonstration NS BASIC and over fifty 
example programs (Newton not included). 

(BNEWT) Our Price $32.35 

SEE RELATED CATEGORY: Dev. Environments 


vW 

Newton 


Programming for the Newton: 
Software Development using 
NewtonScript 

by Julie McKeehan and Neil Rhodes. 

Foreword by Walter R. Smith 


An indispensable tool for Newton programmers. Includes disk with 
sample Newton application from the books, as well as 
demonstration version of Newton Toolkit (NTK) - the complete 
development environment for the Newton" 1 '. A Publication of AP 
Professional May 1994, Softcover, 393 pages. 

(BPROGNEWT) Our Price $26.96 
SEE RELATED CATEGORY: Dev. Environments 


Programming with AppleTalk 

by Michael Pierce 

Programming with AppleTalk is the hands-on guide to understanding 
and working with AppleTalk - Topics include: How to create applications 
and system extensions that run with AppleTalk. AppleTalk protocols and 
the protocol stack, transport media, Preferred AppleTalk Inteface, and 
the storage management. Numerous working code examples walk you 
through using RDEV, INIT, NBP, ATP, and ADSP 
(BPROAT) Our Price $22.45 



Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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Check out our Web site! 

Full product descriptions • Hundreds of more products 
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trmsm Learn c on The 

Macintosh 
Second Edition 

By Dave Mark 

New revised edition! 
Easy-to-understand - 
everything you need to 
start programming. Updated and enhanced 
exercises that lead you step by step. You'll 
learn function, variables, point datatypes, 
data structures, file input and output and 
more! Includes CD-ROM with Metrowerks 
CodeWarrior™ Lite. 

(BLEARNC2) Our Price $31.45 
SEE RELATED CATEGORY: Dev. Environments 



Learn C++ on the 
Macintosh 

by Dave Mark 

Basic syntax of C++ and object 
programming. Learn how to write, 
edit, and compile your first C++ 
programs. Features key C++ 
concepts such as derived classes, 
operator overloading, iostream 
functions and more. Includes a 
special version of Symantec C++ for 
Macintosh. Book/disk package with 3.5" 
800K Macintosh disk. 400 pages. 
iBLRNCPP) Our Price $35.05 
SEE RELATED CATEGORY: Dev. Environments 



C++ 

Programming 
with MacApp 

by David Wilson, 

Larry Rosenstein 
& Dan Shafer 

Learn the secrets to 
unlocking the power of MacApp®, Apple's 
development environment for C++, team to 
design complex windows and views using 
the ViewEdit tool, team to support multipage 
text and graphics with only five lines of code. 
(BCPPMACAP) Our Price $31.46 
SEE RELATED CATEGORY: Tools, Lite & Utilities 


Object 
Oriented 
Program 
Design 

by Mark Mullin 

A concise guide to the 
concepts and 
techniques of OOP 
design. Clarifies the key concepts of object 
oriented programming such as objects, classes, 
entities, hierarchies, and inheritance. Uses 
typical database application to illustrate each 
OOP topic, to give a familiar point ot reference. 
(ROOPRODES) Our Price $20.66 
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Perl Quick Reference 

by Michael 0. Foghlu 

Commands are sorted by task, class packet, 
platform or hardware compatability ail in 
alphabetical order. Includes jump tables to 
guide reader to specific pages in the 
reference. Designed in a larger trim size than 
traditional Quick References-and with a lay- 
flat binding. 

(BPERLREF) Our Price $17.99 



OBJECTiVE-C 

Object- 

Oriented 

Programming 

Techniques 


by Lewis J. Pinson and Richard S. Wiener 

Presents the basic concepts of object- 
oriented design and programming, and 
provides a precise description of the 
Objective-C language. Several small to 
medium-sized applications using Objective- 
C illustrate the general principles of object- 
oriented programming. Covers the two main 
versions of the Objective-C language. 
Demonstrates the versatility and power of 
the NeXT machine as a platform to support 
object oriented programming. Shows how 
to design, implement, and use hierarchies 
of classes. Explains the purpose of pre¬ 
defined classes and shows how they can 
be used in designing programs. 
(BOBJCOOPT) Our Price $34.15 



Macintosh C Programming Primer 
Volume I 

Second Edition, Inside the Toolbox Using THINK C 
by Dave Mark and Cartwright Reed 

Updated new edition ot the Macintosh programming best 
seller. System 7, new versions of THiNK C and ResEdit. 
Learn how to use the resources. Macintosh Toolbox and 
interface to create stand-alone applications. 672 pages. 
(BCPRiMi) Our Price $24.25 


Macintosh C Programming Primer Volume II 

Mastering the Toolbox Using THINK C 
by Dave Mark 

Covers advanced topics such as: Color QuickDraw, THINK Class Library, TextEdit, and 
the Memory Manager. 528 pages. 

(BCPRIM 2 ) Our Price $24.25 


MacsBug Reference & 
Debugging Guide 


For MacsBug version 6.2 
by Apple Computer, Inc. 


MacsBug Is an assembly •language-'^ 
level debugging tool. Includes 
macros, templates, demds, and 
other resources for making debugging * RO 
easier. Covers how to display and set 
memory and process registers, disassemble 
memory, and set execution breakpoints. 
Explains Discipline, a tool for testing the 
validity of toolbox parameters, and 
debugging strategies to find & cure common 
bugs. Includes MacsBug 6.2. 


(BBUGREE) Our Price $31.46 
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Mastering the THINK 
Class Library 

by Richard Parker 

Provides a thorough examination of 
Symantec's extensive Class library and 
the Visual Architect. A complete 
description of the structure and 
operation of the TCL includes 
explanations of all code generated by the 
Visual Architect, any necessary custom code, and the operation of 
this code. Visual Architect tutorials provide you with a step-by-step 
approach for simplifying the development of complex Macintosh 
applications, 496 pages. 

(BMASTERTCL) Our Price $26.95 
SEE REIATED CATEGORY: Dev. Environments 



Visual Programming with Prograph CPX 

by Scott B. Steinman and Kevin G. Carver 

An introduction to the language and a guide for advanced users, 
for both Macintosh and Windows-based machines. 

(BVISPRO) Our Price $30.60 

SEF RELATED CATEGORY: Dev Environments 



The Power of Prograph CPX 

by Dan Shafer 

Master the revolutionary graphical object- 
oriented programming language. Step-by-step 
course through three interrelated projects of 
increasing complexity. Learn Prograph 
language, CPX classes and object editors. 
Includes disk with all code in the book. 
(BDANPRO) Our Price $19.95 


Inside CodeWarrior 12 

by Metrowerks 

Includes CodeWarrior IDE User's Guide. This is the printed 
version of the documentation provided on the CD. Covers 
CodeWarrior, the debugger and associated tools. 



(BiNSCW) Our Price $34.95 


SEE RELATED CATEGORY: Dev. Environment 


Metrowerks CodeWarrior Programming 

by Dan Parks Sydow 

Includes CodeWarrior Lite, and Full Coverage of PowerPlant™. 
The best information on Metrowerks CodeWarrior, giving full 
coverage to the Gold Edition. CD includes Code Warrior Lite. 
(BCWPROG) Our Price $35.95 


Check out our Web site! 

• Full product descriptions • Hundreds of more products 

http://www.devdepot.com 


C++ Programming with 
CodeWarrior 

by Jan L. Harrington 

Beginning OOP for the Macintosh and Power 
Macintosh and Mac OS compatibles. Learn 
object-oriented programming techniques 
using C++ as the example language and 
Metrowerks and CodeWarrior as the example 
compiler. Enclosed CD contains example code from the book and a 
full-function Metrowerks CodeWarrior. 

(BCPPCW) Our Price $32.35 



CodeWarrior Software Development 
Using PowerPlant 

by Jan L. Harrington 

C++ programmers will team to develop object-oriented software 
applications for the Mac and Power Mac using the PowerPlant 
environment and the classes that support it. Covers CodeWarrior 8. 
Included CD-ROM contains source code tor all the programming 
examples in the book and Metrowerks CodeWarrior Lite. 

(BCWSWDEV) Our Price $31.45 


Inside PowerPlant Manual 

by Metrowerks 

Create PowerPlant applications using the CodeWarrior IDE and 
PowerPlant Constructor. Full descriptions of major PowerPlant classes 
and resources. Included are the PowerPlant Constructor Manual, 
including View, TextTraits and Custom Types editing, and PowerPlant 
Library Reference, covering all classes and functions in PowerPlant. 
(BiNSPP) Our Price $34.95 
SEE RELATED CATEGORY: Dev. Environment 


Macintosh Pascal 
Programming Primer 
Volume I 

Inside the Toolbox Using THINK Pascal 
by Dave Mark and Cartwright Reed 

This tutorial shows programmers new to 
the Macintosh how to use the Toolbox 
resources, and the Macintosh interface to 
create stand-alone applications with 
Symantec's THINK Pascal. 544 pages. 

(BPASCPRI) Our Price $24.25 
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AppleScript Language Guide 

by Apple Computer, Inc. 

A complete reference for anyone using AppleScript to modify existing scripts or to write 
new ones. Contains useful information for programmers who are working on scriptable 
applications or complex scripts. Features detailed definitions of AppleScript terminology 
and syntax in the following categories: Value classes, commands, objects and 
references to objects, expressions, control statements, handlers, and script objects. 
Includes many sample scripts, discusses advanced topics such as writing command 
handlers for script applications, the scope of script variables and properties declared at 
different levels in a script, and inheritance and delegation among script objects. 

(BALG) Our Price $26.95 
SEE RELATED CATEGORY: Scripting 


Order Toll-free 
800-MACDEV-1 

1800422-33811 

AppleScript Applications: 
Building Applications with 
FaceSpan and AppleScript 

by John Schettino Affiliation & Liz O’Hara 

Build complete AppleScript applications using 
FaceSpan, a user interface development tool 
that makes AppleScript applications truly 
“ Mac-Like N . Uses a step-by-step approach 
to demonstrate techniques for building 
applications through illustrations and 
samples. Provides Graphical User Interface 
(GUI) design tips and practical approaches for 
implementation. Contains one CD-Rom with 
AppleScript 1.1, a demonstrations version of 
FaceSpan 2.1, source code for all example 
applications numerous AppleScript shareware 
and demonstrations programs. Contains a 
section on debugging AppleScript 
applications using FaceSpan. 

(BAPSCAP) Our Price $31.45 


Applied Mac Scripting 

by Tom Trinko 

Learn to design and develop powerful scripts. 
Covers AppleScript " M , Frontier, QuicKeys, 
Tempo II, nShell. FaceSpan Application 
Builder. Scripting PlainTalk and System 7.5. 
Hands on tutorial shows you how to automate 
your Macintosh activities by learning how to 
use the AppleScript and Frontier scripting 
environments. Harness the capabilities of a 
wide variety of Macintosh applications into 
the integrated productivity tools. This includes 
such things as the newspaper script which 
combines the power of SITcomm, MacWrite 
Pro, and FileMaker Pro. or QuarkXPress. 

(BAPPUED) Our Price $31.45 
SEE RELATED CATEGORY: Scripting 


AppleScript Scripting 
Additions Guide 

by Apple Computer, Inc. 

Use the standard scripting additions 
commands. Write scripting additions. 

(BSCRADD) Our Price $17.05 
SEE RELATED CATEGORY: Scripting 
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The Elements of E-Mail Style 

by Brent Heslop and David Angell 

Write solid, effective E-Mail and avoid common pitfalls. 
(BEMAIL) Our Price $13.45 


AppleScript Finder Guide* 
English Dialect 

by Apple Computer, Inc. 

Provides definitions for Finder object classes 
and commands. Write, record, or run scripts 
that trigger the same desktop actions that 
you trigger using the keyboard and mouse. 
(BAFG) Our Price $17.95 

SEE RELATED CATEGORY: Scripting 
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Web Page Scripting Techniques 

by MacMillan 

Manipulating color effectively. Placing images and using 
shapes. Using JavaScript functions and objects, plus 
VBScript functions and objects. Determining users browser 
type and operating system. 

(BWEBPST) Our Price $45 
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Netscape Navigator 3.0 

by Bryan Pfaffenberger 

Learn the best Web surfing 
techniques. Quickly find your way to 
valuable information on the Web. 

Learn to use the new plug-in tools, 
including Live3D and Real Audio, Send 
and receive electronic mail to anyone 
on the Internet. Utilize the enhanced 
security features for on-line shopping 
and ordering. 

(BNETN3) Our Price $26.96 
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Netscape Navigator 
Starter Kit for Macintosh 

by MacMillan 


Create your own home page in minutes 
and add hyperlinks to your favorite web 
sites. Add graphics, audio, and video. 
Download files via FTP. Load plug-ins to 
enable movies, audio, animations, and 
more. 

(BNFTNSK) Our Price $31.49 



Building and Maintaining 
an Intranet with the 
Macintosh } 

by Tobin Anthony *! 


Intranet 


Set up services such as video conferencing, 
Real Audio, message boards, employee 
scheduling, e-mail, WWW, ftp, and many 
more. Find a simple, cost-effective solution to providing corporate 
Information to company employees. Learn how to open portions of 
your intranet site up to the internet while keeping private information 
safe, Companion CD-ROM. 

(BBAMAI) Our Price $45 




Planning and 
Managing Websites 

by Jon Weiderspan 
and Chuck Shotton 


The definitive guide to setting up and running 
a Web site on the Macintosh. Learn everything 
you need to know about using WeOSTAR, the 
best known HTTP server software and its 
shareware predecessor MacFfTTP, Write CG! applications for your 
server - in AppleScript and in C. CD includes a special version of 
WebSTAR, plus tons of useful software, 

(BPLAMWEB) Our Price $35.96 


Check out our Web site! 

• Full product descriptions * Hundreds of more products 

http://www.devdepot.com 


Internet Publishing with 
Adobe Acrobat by MacMillan 

Optimizing PDF for Web viewing, integrating 
HTML and PDF. selecting PDF page 
dimensions, PDF file evaluation. Setting 
links to PDFs and URLs, PDF forms, 

Security algorithms. Configuring Web 
servers for PDF, Embedded PDFs, PDF 
creation techniques. 

(BIPWAA) Our Price $36 

Providing Internet Services 
via the MacOS 

by Carl Steadman and Jason Snell 

Shows you how to provide Web pages, FTP, Gopher, e-mail, and more 
with the Mac OS. Includes CD-ROM containing all the Mac server 
software and utilities you need, 

(BPROVNET) Our Price $31.46 




Cyberdog 
Programmers Kit 

by Apple Computer, Inc. 

Apple's official reference. A must for 
developers who want to make 
customizable Internet access available to 
all Mac users. Included CD-ROM contains 
all the tools needed to create Cyberdog- 
aware components, 

(BCYBEROOG) Our Price $34.95 



Special Edition Using CGI, 
2nd Edition 

by Jeffry Dwight, Michael Erwin and 
Robert Niles 

This complete reference provides 
professional Web developers and advanced 
personal users with the latest information 
on using CGI (Common Gateway Interface) 
to Interact with databases, 

• Explains client and server uses of CGI 

• Provides extensive coverage of live audio and video feeds, user 
chat and interaction, and CGI security 

• Features separate chapters devoted to language-specific tips, 
tricks, and traps 

• CD ROM is loaded with the HTML and CGI sample code from 
the book 

• Includes applications for guest books, mail and new gateways, 
browser identification, access restriction, and shopping carts 
(BSEUCGI) Our Price $44.99 
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Java in a Nutshell 

by David Flanagan 

A complete quick reference guide to Java, 
the hot new programming language from 
SunMicrosystems. Contains descriptions of all 
of the classes in the Java 1.0 API. with a 
definitive listing of all methods and variables. 
Also contains an accelerated introduction to 
Java for C and C++ programmers who want 
to learn the language fast. 

(BJAVANUT) Our Price $13,45 


Hooked on Java 

by Arthur Van Hoff. Sami Shaio 
and Orca Starbuck 

Written by the Java development team at Sun 
Microsystems, Inc. An introduction to using 
applets, for Web administrators, designers, 
and developers. Demonstrates how to use 
applets in your own pages. Includes a concise 
introduction to the Java language, and a CD with tools. 

(BHJAVA) Our Price $26.95 

Java Language API SuperBible 

by Daniel Groner.Todd Sundtsed, Casey Hopson 
and Harish Prabandham 

Covers Java 1.1. Provides hundreds of concrete source code 
examples. Sample projects introduced & assembled in each chapter. 
(BJLAS) Our Price $53.99 


Intranet Web Development: 

Enterprise Alternatives to Client/server Computing 
by Hayden Development Team 

Learn why traditional client/server computing is being replaced by 
new WWW technologies. Discusses WWW application development 
with the Microsoft Visual Script enterprise application developer in 
mind. Learn techniques for the conversion of existing Visual Basic, 
C++ and PowerBuilder Applications to the new WWW platform. 
(BINTWD) Our Price $45 



JavaScript for the Macintosh 

by Matt Shobe and Tim Ritchey 

Allows non-programmers to take advantage 
of the power of Netscape Navigator. Expand 
the capabilities of your Web page, without 
having to understand C or C++. CD-ROM 
contains “Wizlets" that allows you to easily 
create your own JavaScripts. Takes you step- 
by-step through programming cross-platform JavaScripts. Details 
how to create JavaScripts for JavaScript-aware Web browsers. 
(BJAVASCRPTJ) Our Price $40.50 


JavaScript 

for Macintosh 


Barky Boone 
fine Dave Mark 


Learn Java 
on the Mac 

by Barry Boone with Dave Mark 

Easy-to-follow introduction for beginning 
programmers and Webmasters. Takes you 
through the core concepts of Java. Includes: 
Object-oriented techniques, unique features 
such as garbage collection, and basic 
programming concepts such as working with variables, threads and 
classes. Learn to apply this knowledge to write original Java applets 
for Web pages. Includes CD-ROM 

(BLJAVA) Our Price $31.45 




Teach Yourself Java for 
Macintosh in 21 Days 

by Laura Lemay and Charles L. Perkins 
with Timothy Webster 

Add interactivity and multimedia to Web pages! 
A step-by-step guide to make your Website 
come alive. Learn the basics of programming 
Java applets and the concepts behind the Java language. Includes 
CD-ROM with a limited version of Roaster, the first commercial, 
integrated applet development environment for Java for the 
Macintosh! 

(BJAVAMAQ Our Price $36 



PRODUCT 

CODE 

OUR PRICE 

CGI By Example 

BSGIBE 

31.45 

NetObject Fusion Handbook 

BNETOFH 

45.00 

Leam HTML on the Mac 

BLHTML 

26.95 

Mastering Netscape 2.0 for Mac, 2nd Ed. 

SMASNET4 

36.00 

Infini-D Revealed 

SINFDREV 

40.50 

DeBabelizer: The Authorized Edition 

BDEBTAE 

40.50 

Sex, Lies and Video Games 

BSEX 

31.46 
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3D Graphics 
Programming 
Using QuickDraw 3D 

by Apple Computer, Inc. 

Incorporate spectacular 30 graphics into 
your applications. Explore QuickDraw 3D, 
a revolutionary graphics extension to the 
Mac OS for Power Macintoshes. CD 
contains the complete QuickDraw 30 
system itself and a complete database of the QuickDraw 3D API, 
allowing you instant access to the hundreds of graphics calls via a 
fast viewing engine. Book/CD-ROM, 640 pages. 

(B3DGRAP) Our Price $35.96 


'Dicks of The Mac Game 
Programming Gurus 

by McComack, Ragnemalm, Celestin, et al. 

For beginning to expert game 
programmers. Complete overview of all the 
necessary components ot game 
programming on the Macintosh. Packed 
with valuable tools, utilities, sample code, 
CodeWamor™ Lite and game demos. 
QuickDraw 3D and Power Mac optimization and inside info on how 
Glypha III was created. Hundreds of tried-and-true tricks, tips, and 
insider secrets from well known Mac game programming experts. 
(BTRICKS) Our Price $45 







3D Graphics-Tips, 

Tricks, & Techniques 

by David Kalwick 

Written from a user’s point-of-view, this 
book covers all the important 3D 
techniques including lighting, 
textures, animation, camera 
angles, and perspectives. 

Through easy-to-understand 

examples you’ll learn how to create high-quality 3D graphics. 
Includes a Windows/Macintosh CD-ROM featuring tutorials, 3D 
examples from the book, and more. 


(B3DGTTD Our Price $31.46 


Black Art of Macintosh 
Game Programming 

by Kevin Tieskoetter , 

Develop your own 3D games in \gF x ' ,, 
C on ttie Mac. Includes CD with B 



MACINTOSH 

GAME 

PROGRAMMING 


project tiles tor both Symantec 
C and Code Warrior. Create * * ° 

freeform texture-mapped games and 
polygon graphics. Control dynamic source 
code - all compatible as native to the Power Mac. Write directly to 
the screen, bypassing QuickDraw. 

©BLACK) Our Price $35.99 




Graphic Gems V 

Edited by Alan W. Paeth 

Loaded with practical tools for 
implementing new ideas and 
techniques, to offer working 
solutions to real programming 
problems. Contains over 40 new 
gems in ellipses, splines, Bezier 
curves, and ray tracing - 
displaying the most recent and 
innovative techniques in graphics 
programming. Includes a disk with 
source code tram all five volumes. Available in bath IBM and 
Macintosh versions. CONTENTS: Algebra and Arithmetic 
Computational Geometry, Modeling and Transformation, Curves and 
Surfaces, Ray Tracing and Radiosity. Halftoning, Image Processing, 

and Utilities, _ 

©GEMS5) Our Price $44.95 
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Advanced Color Imaging 
on the Mac OS 

by Apple Computer, Inc. 

Enhance your software's color capabilities 
with step-by-step instructions. Augment 
the color support supplied with 
QuickDraw, and QuickDraw GX. Use the 
Pallette Manager to get the best colors on 
limited displays. Match colors between 
screens and input/output devices (scanners & printers). CD includes 
a complete reference information in both QuickView and Acrobat 
formats. Plus, a sample application demonstrating ColorSync 
programming techniques. 

(BADVCI) Our Price $33.25 



Order Toll-free 
800-MACDEV-1 


180063533811 
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Here are more products. For full product descriptions please see our 
Web site, or feel free to call, fax, or E-mail us. Our prices on books are at 
least 10% off list price. 


PRODUCT 

CODE 

PRICE 

Development Environments 



AppleScript Applications: EMkirig Applicate w/FaajSppn. 

Basic for the Newton • Programming using NS BASIC. 

.0APSCAP,™. 

.BNEWT.,. 

S31-45 

32.35 

C++ Programming wrtti CodeW^irjor..,,,,,,,,,,,,,,,,,,...... 

......BCPPCW... 

32,35 

C/C++ SDK Usui's Guide...... 

.. ...BCPPUSER. 

2900 

CftteW&nip* Inside ftowerPfent .. 


34.95 

CpdsWsrrior Software Devctopmoni os^ig PoweriPlartl... .. 

. &CWSWOEV.. 

31.45 

Dan Shafer Prcscmte the Power ol Pi ograph CPX ... 

.BQANPBO 

19.95 

FORTRAN SDK IJasr's Guide...* . ... 

. BfonrusEn ........ . 

34.95 

Inside CodeWamor Book. . 

.UM5CW .. 

34.95 

Last Resort Programmers EdSinrt... w ..„.. 

..BLSTRSRT . 

74.95 

Lram C on Ifei MariiUnsh, 2nd Ecfiilon ....... 

.BLEARNC2. 

.31,45 

Mastering Ite Think Class Library „. 

.BMASTEH1CL 

26.95 

Metrowerks CoCteW&nlcr progrtnwrurig... 

.8CWPR06. 

3595 

CMbbcimb-C - Object Oriesnlcd Programming.. . 

.BO04COCPT . 

.34 15 

Pi lulling Magi: Cap_ _ _ . 

bpfcsmagk: . 

15.25 

Real World Apple Guide. 

. entAtwiB ... 

35 J5 

Symantec C++ Protpanimtog........ .. 

.. BSYMCPP... 

. 39.50 

Tallgent's Gtedp to Desiring Programs... 

.BTFAliGCNT. 

17.55 

Visual Programming with Prograph.. 

...HVEFTO. 

30.60 

Witetess Fot Tha Newton 


.. . 31,45 


Hardware 


Apple CD-ROM Handbook ... 

Designing Cards & Drivers for the Mociitosh 
LaserWriter Reference--- 


PQ System Architecture 3rd bffl&on .. 
PowerPC System Architecture 

Internet Related 


BdJHANU 

9CAflD..„. 

RET.. 

.BPOSYS. 

...BPPCARCH... 


14.36 

26% 

17.96 

31.46 

31.46 


1994 Internet White Pages. 

Active Java... 

America Online lor Dummies... 
CQ By Eampte^. 


. J94WHITE.. 
....BACTJAVA.. 

■ ■■■BAOUHM— 


Computer Privacy Hitodbook.... 

fc-Mail Essentials... 

Elements uf F-Mail Style. 

Hooted on Java.. 


BW. 

BFMME . 

BCMAIL. 

0HJAVA.... 


26.95 
23.3B 

17.95 

31.45 

22.45 

22-45 

13.45 

26.95 


mtiemei Book. rrir .. .... 

BmCMTT.... 

22.50 

Internet for Dummies 2nd Edition ..... 

DNETDUM2. 

17.99 

internet for Dummies Quick Retatjncc. .._ 

BDUMOCK . 

. 9.05 

internet tor Macs tor Dumrracs. 

0NETTXJM. 

17.95 

Internet tor Macs for Dummies Bestseller Edition... 

Intend Piwffii Tools... . . .. 

mcMicnoc 

Qpwmoa. 

,.,35.99 

36.00 

Entemel Publishing with Adobe Acrobat. .._ 

ejfwaa. 

.... 36.00 

internal Secrets... ...... 

BSECRET . 

35.99 

Interne!, The. Deka: Edilion....,.. . 

riNnoaux. 

.31.50 

Intranet Web Dev.. Enterprise Wtamatives to ONt^Tt/Sorvcr 

...BWTWD,.,. 

44.99 

.tort Essentials tnr fLTT** Prrajmnimw 1 ; 

BJAVAESSEN 

17,95 

Java in a Nutshell .,... r ..,„ r „„ r „ M11 „,,_ L1 _ ,, 

...BJAVANUT,— 

13,45 

*fava Language API Superfrbie.... . 

..MAS. 

53,99 

.JavaScript ter Macintosh...._. ... 

...BJAVASCHPf 

40,50 

Leant H1MLon the Macintosh. ... ,. 

...BLHTML. 

26.95 

Leant Java on tha Macintosh. 

, .BLJAVA... 

..3145 

Mastering Ntilscape 4.Q for Macintosh, Second Edition . 

...IMASNFT4. 

.. 36.00 

More Internet for Dummies Starter IQ!. ... 

..fltXJMNfcl 

17.95 

Mosaic for Dummies .. . ..... 

BMOSDUM. 

17.99 

Net Chat... „. .... ...... 

BfCTCMAL. 

,,,,,,17.00 

M#n^sriittonHinnHir 

BhETOFH 

45,00 

Netscape Navigator ,„. L „„ Lirr ...„,.., J1M1J , 

BNETNAV .. . 

26.95 

Netscape Navigator Starter ten .. ... .. 

..BNETTfSK................ 

31.49 

Pell QliCk flBfPffffCT „rrr,......... . 

RPERLREF„. 

17.99 

Pfenning and Managing Web sites......... 

...BflANWEO. 

35.96 

ftojvidinfl internet Services.. 

BPRtMlEl. 

31-46 

Plihlish it m ihr Wlnti . 

BWEBPUB. 

3146 

TCPAPVof 1 -Vol t Bundle .... . 

BTC3 J 12tMlL 

99.00 

Teach Ycuaell java in 2i days ,,_. .,,, .. 

SJAVAMAC 

36,00 

Underground Guide Ed Totecommi/ting. ......... . . 

bunder . 

22,45 

Web Head Mac Guitfc... 

BWffitFAn .. 

22.45 

Web F'age Stripling Tecfmlctuos.. . ' ... 

...OWEBPST. 

45.00 

Wflb Weaving. 

...BWWEAV. 

22.45 

Webmaster Macintosh ..... 

. BWEBMAS . 

26.95 


Scripting and Solutions 


AppteScnpt AppilcaUons: Buildrraj A|*r> with FacaSipsn., 
Applied Macintosh Scripting .. 


Comptete AppleScript Harefcaok. 

Complete HyperCard 2 2 Handbook . 

Danny Goodman's Apple Guide Starter Kil 

HyperCard Stack Design... 

HyperTalk 2.2: the Book... 

JavaScript tor Madntosh... 

Port Quick Reference-- 


Real World Apple Guide. 

Technical Reference 


sapscap.. 

BAPPtED„ 
.JiAPtSCRHB... 

.BHYPCKE 

....BDGAGSK. 

.. ..BHtfSTA.. 

.BHYPTAL........ 

.HUAVASCHPT . 

6PERLREF. 

bhfaimd. 


31.45 
- 31.45 

31.50 
, 31,50 

31.46 

19.95 

31.50 

40.50 
17.99 

35.95 


todiveJava. .. 


.RACTJAVA. 

23.36 

Appte CD-ROM Handbook 


.BCDHAND 

14.36 

Art of Human iniedaoa Design. . 


.bahid 

23.65 

Black Art of Mac Game ProorErnming.... 


.BBLACK 

35,99 


PRODUCT 
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PRICE 

C+ f for Dummies ........ 



....8CPP0UM. 

17.95 

C for Dummies Vm i ...... 



BCDUM. 

17.95 

Developing Object Queried S<3Tlwr+rw far Ihe Macmtsash,, 
Essentlul OpenDnc......., 

— 

— 

....BDCVOR. 

....besod. 

35.95 

Extending the Mac Tffiribox 



JETMl 

22,46 

Foundabons of Macintosh Prpgmrmning 



.. BFOUND .. 

. 35-96 

Eragment of liiiugitialiDfi .. 



BFRAG„. . 

.35.96 

Guide to Macintosh Snftware L real ration 



... BLOCALIZ __ 

.24.26 

Guide id Macintosh System 7,5.,.... 



RSYS7T>. 

22.50 

How to Write Macintosh Software .... 



....flWWTF. 

....26.05 

Inside AppleTalk, ,, ..... 



....baftalk. 

.31.45 

Iruiite lire Macinlcsh Communtcabans Toolbox 



„..BCOMM .... 

22.45 

LaserWriter Rafemnpe 



BLASERREF . 

17.96 

Leant C++ on ttio MaweittH 



. Bl HNGPP..™ 

.35.05 

Learn Con the Maonfoshy IstEJUan. 



DLtARNCI_ 

_.31.45 

1 earn C on the Macintosh, 2nd Ldtbcn ___ 



..„BLEARNC2 ... 

..31,45 

Mac Programming tor Dummies ............ 



..BMACDUM 

.A7.95 

Macintosh C Programme Primer Voluntfl 1__ 



. RCPfllMl . 

... .24.25 

Macintosh C Programmer Primer Volume 2 .*. 



...JCPWM2. 

24.25 

Macintosh DLE2 Prog. Heteranco Wbrfcmg with Objetls. 

Macintosh Pascal Progratninliip PriiTutr Volume l.. 

•— 


.B0LE2. 

...BPASCPRI__ 

.,40.45 

...24^5 

Macintosli Programming fia:rrts .... 



.. ..BPSCCniTT_ 

..,58.76 

Macntcetfi Programming TecrirttooSS... 



.....BPTtCH,. 

31,95 

More Mac Progrnmming Techniques.. 



. ...BMOftEIECH . , 

34,50 

Network f-rontiora Bundle .. .. .. 



BNTFTB . 

59,95 

NeXTStep [tev^iftoterl Tods & Techniques . , 



...JNEXTDTT. 

.27,85 

NeXTStep General Eteferance.... ... 



. 

. . 40.45 

NeXTStep Programming interface Summaiy. 



HNEXTPiS . 

...27.86 

NoXIStep Usor Interface Giidellnes.,...... 

Nowton Prograrrnning Guide. 



.RNFXTIJIfi. 

.22.45 



....BNEWrPGJD... 

40.46 

Otyed DnenHed TVogramming Design .... 



.iJUQF’HQtltS 

2066 

Optlnrtinng ItowerHC Code.. 



.60PTPPC. 

35.96 

PostSfifOt Language . 



BPS AMRO - . 

29.66 

Pmwrtnok ffigiial Nomad's Guide... . .. 



RPRTDNP 

.2246 

PmwsrPC Prograrranfir's ToaW^....... 




40.50 

Programming introduction to Irie Madnimdi family_ _ 



FAMILY. 

22,46 

Programming for Sysfem 7.. ., L 



.BSYS7. 

.24.25 

PrograrTmini] Primer Macintosh Volume 1 



.OPRIMMAL 

34.15 

Programming DukMJraw. 



.tfTODRAW . 

24.25 

Progfammtofl Starter Kit___ 



.... BPBOSTART . 

49.50 

ProghFnmng will AfpleTaSt ..... 



. .npnoAT...,... 

^,45 

QuickTime - Official GuWe tor Macintosh Uses.. 



.....BOTGUlOt_ 

45.00 

QuickTime Starter Kit for the Macintosh 



.0OTSKTT. 

40-50 

Heal Wald Appro Gwto... 



eftfAlWID 

3595 

ResEdll All Niyll Diner .. . . . ... .. . 



.BRESDINE. 

22,45 

ficsFdl! Gompiiie, 1st Edrlion. 



.BBEStEM 

31.45 

ResEdlt Compteto, 2nd Edition. 



.BRESED2_ 

31.45 

ResEdll Hafarience........ 



.8RESEDRIT .... 

26.96 

Saltwort! hy ftesyu: Createig User Fnendty Software 



....JBDCSKjN,.... 

. 26.95 

Symarilec C++ kr too Macintosh The Rases 



.BSCHMTB 

.31.46 

Teach tteursaif Macirtosh C++ m 21 Days. 



. . .JCPP21D . 

.2699 

technical Introduction to Iho Maalash FanuN. 



.... RTITTMF,_ 

..24.26 

Tog on Software Deskjn_..... ...... .. 



.BTOG. 

26,95 

Wuoiess for ihe Newton Devetopmom for Mobi Comm. 



....BWtrttLESS. 

.31 45 

Wrili™ Lncflllzahlfi aslfwarc 



BLOCAl..._ 

2425 

Miscellaneous 

Adobe Premiere for the Macintosh.. 



FV’REUt 

44.95 

America Otfne In Dummies. . . ... 



RADI HUM „ , 

.17,95 

Art of Unman interlace Deign.. .. 




79 65 

Cn noM Cuirte m MuJUtmenia Amtnmng .. T1 .. 



. 

... BCDMULTI...... 

.40.45 

CompuServe for Dummies . . _ 



BCSOUM. 

17,95 

Creating Intoraclwe CD-ROM...^.,,,.., 



.BWTEBCDR. 

..35.95 

Cyberpunk Handbook. . .. .... . 



....BCYBF'UNK 

8.95 

Darmy Goodman's Maclntoch Hartobook .. 



. BGOODHB ... 

26.95 

EmmeWorks .Snume Grate Di?ik .. . 



MTFWSC . 


FitfteWbfta Magarirv Back Issue___ __ 



...WWBACK 

... 6.00 

Global Interface Design. 



HO fWAl 

32.35 

GntpTiir t* 



...BGB4S2.. 

. 44.95 

Graphic Gems 4 .. 



BGFMS4 

.,,,,.44.95 

Graphic Gents V, .. 



BGEMS5 , , 

4405 

lurini-D Revealed. 



.. BINTUKfcV ...... 

.... ...40,56 

Late Night with MacHack. .... 



....ELATE. 

.2695 

Mac Bathroom Reader . 



BBATil. 

11,70 

Mac Satram&i' The UHimote MaCtotOSh Supercharging Kd ... 



BSCRtAM.... 

.31,50 

Madritosh Crash Course.. ,,.__ 




26.95 

MacTedi Back Issues .. 



MTBACKISS 

10.00 

Macworld Ultimate Muriiilcim Book . .... 



BtlTMAG 

35.85 

Marragmy AppleShare 4 Workgnx^j Servers... ...... ..... 



... BMAWS. 

26,95 

MADACGN '93 CD-ROM. ... .... 



SMAUA93 

9,95 

Multimedia Autoorlng: Building and Developing Documents.,,. 
Mullrmctfa Storter Kit for Madntosb...... 

— 


...8MMAUTH. 

BMMRTAm. 

.,,.,,..31.45 

.27.00 

Pralli from Experience....... 




...22.45 

Sari Mara ftnmftfi ami JlasaslRr!;. ... 



_.. 

RSADMAC...,_ 

... 22.45 

Stupid Mac Tricks ... . .. ... 



BSTUPfOMAD 

.17.95 

The SohvKtfrr Devetoparts £ Marketer's Legal Companion 
Tncksol Ihe Mac Game^1*,,..... 


-- 

. FISOAMLC-^. 

RTTliraS 

4b .00 

Zen and the Ail of Hesource Edlbng. 



.BZAAQRE. 

27.00 
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All entries in this index are alphabetized. For your convenience the product names 
are bold, book names are italicized and company names are in plain text. 


1000 Games for Macintosh (game section)........19 

3D Graphics Programming Using QuickDraw 3D .... 29 

3DGrsphic$’Tip$, Tricks* & Techniques... ....*29 



A* D, Software..........,,11 

A Fragment of Your Imagination ......23 

A Zf 11 ion Sounds (game section)......„. 

Absoft Corporation........„.,............9 

Adianta Inc. ..*.........„«.,.,1G 

Advanced Cotor Imaging on the Mac OS.......... ,*,29 

Apple Computer, Inc......3, 4. 12, 21, 26 

Apple Dylan Technology Rglpaw .. .-..... 2 

Apple Guide Integration............3 

Apple Media Tool Programming Environment 2.0....4 

AppleGuide Complete..,, ........... ,...,,22 

AppleScript Applications: Building Applications with FaceSpan.. . ..26 

AppleScript Finder Guide, English Dialect ......... 26 

AppfeScript Ftrxfer Guide, English Dialect ..*. ....12 

AppleScript Language Guide ..........26 

AppleScript Scripting Additions Guide ... ...26 

AppleScript Software Development Toolkit 1.1.....3 

Applied Mac Scripting ......................26 

App Maker --------.16 

Arboretum Systems..........*..6 

AudioTrack..................J5 


B 


B-Tnee HELPER 22....*..-.,.15 

Bare Bones Software .............. 11 , 15 

BASIC for the Newton.. ........ 23 

BBEdit 4.0...........11 

BeachWare....,.......„.... .19-20 

Best of MacTutor, ....™...*....... 2 

Black Art of Macintosh Game Programming. ..... ..29 

Bowers Development..—...—....„..16 

Building and Maintaining an Intranet with the Mac .. 27 


C 


0+4 Programming with CotfeW&rrbr .......25 

C++ Programming with MacApp ........ 24 

c*tree Plus® Database Handler......13 

Capiiano Computing.........,..../17 

Captivate 4.6: Essential Graphics Utilities......6 

Casino! (game section)............19 

Gelestin Company...............*14 

CGi Toolkit...._________17 

CGt TooM By Example .......,.........28 

Classic Arcade (game section).........19 

Clip VR™............,,5 

Cod e Mana ger.....................7 

CodeWarrior for BeOS DR2............7 

CodeWarrior Gold 12.........—-.7 

CodeWarrior Wear.........*_......7 

Compi lettL... .................14 

Conix Graphics...,.....,.17 

CPU Doubter...™........13 

CronManager .................13 

CW Software Development Using PowerPoint ...... 25 

Cyberdog Programmers Kit. ............. 27 


Danny Goodman’s Apple Guide Starter Kit ..... 22 

DeBabeiizen The Authorized Edition..., ...*..... .....23 

Design Works 4.0 ...........,.17 

Development Environments, additional products......10 

Digital Technology International.......12 

Digtool, Inc...,.„„........... 9 

dtF Americas.......... t „„.15,17 


E 


Essentia* OpenDoc. ....,...... 22 

eUbx Productions....„.... 5 

Excel Software.......*.,..........14 


F77 SDK,,... 

FaceSpan v2.1... 

Farreom..,,,... 

Fortner Research LLC 

Future Basic II. 


..12 

,13 

,8 

.15 


G 


Goldilocks Gamebook (game section).„......19 

Graphic Gems V .,.«.....29 

Guarantee Terms..........1 

Guide Composer™ 1.2— ...„„.— ......13 


H 


Hooked on Java ........ 28 

Hyperprism-SSK Real-Time Sound Effects Processing.....6 

Hyperprism-MMP Real-Time Sound Effects Processing......6 

Hyperprism - PPC Real-Time Sound Effects Processing......6 

Hyperprism-TDM Real-Time Sound Effects Processing*.*.......6 


frrfhFD Revealed ....„..... 

Inside CodeWarrior 11 ...... 

tnsrde Macintosh; AOCE Appticatbris Interface.. . 

Inside Macintosh: AOCE Stervce Module.,, ..... 

inside Macintosh: CD ROM ....... 

inside Macintosh: Devices ..,..... 

inside Macintosh: Files. ........ 

inside Macintosh: Imaging with QuickDraw. .... 

Inside Macintosh: Interappkcation Communications . 

/nsitfe Macintosh: Macintosh Toofoox Essentials... . 

inside Macintosh: Memory...-....».... 

inside Macintosh: Mom Macintosh Toolbox ... 

inside Macintosh: Networking ..... 

Inside Macintosh: Operating System Utilities..... ... 

inside Macintosh: Overview ......... 

Inside Macintosh: PowerPC Numerics. ...„... 

Inside Macintosh: PowerPC System Software... .,,. 

Inside Macintosh: Processes ...... 

Inside Macintosh: QuickDraw GX Erwiron. & IM. ... 

Inside Macintosh: QuickDraw GX Graphics . 

Inside Macintosh: QuickDraw GX Objects ..... 

Inside Macintosh: QuickDraw GX Printing ... 

bside Macflifosh; QuickDraw GX Printing Extension . 

Inside Macintosh: QuickDraw GX Prog. Overview ... 

Inside Macintosh: QuickDraw GX Typography .. 

inside Macintosh: QuickTime ...„.. 

inside Macintosh: QuickTime Components .. 

Inside Macintosh: Sound.. ...... 

inside Macintosh: Text ....... 

inside Macintosh: X-Referwce... ........ 

inside pQwcrPtanf Manual ..... 

Internet Publishing with Adobe Acrobat.. ... 

intranet Wet? Development,... ...... 

Ionizer Real-Time Dynamic Spectral Reshaping Tool. 


...28 

...25 

..,.27 

....27 

,.,27 

...27 

...27 

.,,27 

.,.27 

.,,27 


....27 

.. 21 

..,,.27 

.. 21 

..27 

......27 

„.27 

...,27 

.. 21 

..27 

..27 

..27 

...27 

..27 

.27 

.27 

.,...27 

...,27 

.....27 

......25 

...27 

... 28 

....6 


Java in a Nutshell. ................ ,,,.28 

Java Language API SuperBIble. _ .__________ 28 

JavaScript for the Macintosh ......23 


Late Night Software Ltd.............12 

Learn C++ on the Macintosh. ....,„.... 24 

Learn C on The Macintosh Second Edition.. .......24 

Learn HTML on the Mac. .......... 28 

Loam Java on the Mac ......... 28 

Legtop Podeum..—....13 
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Live Access™ t Developer Edition „„***„...„„*..**..17 

LiveAccess™ 1 User Edition,.,.*,......17 

LS Fortran Plug-In.,*,.*.......... B 

LS Fortran Pro............ & 


Mac OS 8 Revealed ....*.* ... 22 

MacA&D 6,0„„_*.......______..14 

MacFlow™: Flowchart Design and Development,,-----16 

Macintosh C Programming Primer Volume /... 24 

Macintosh C Programming Primer Vbtume tL... ....... 24 

Macintosh Common Lisp 4.0........**«„. 

Macintosh Pascal Programming Primer ibiurm I ...... 25 

Macintosh Programming Secrets,., ...... 23 

MacsQug Reference & Debugging Gt/kfe... ...*... ...,„,24 

MacTech.............. 2 

MacTech CD-ROM Volumes 1-11....... 2 

MacTech Mouse Pad ....*..**„*.... ....2 

Magreeable Software.... ..............15 

Main Event Software........... 

Mainslay--..............£, 9, 


Mastering the THINK Class Lforary. 

Memory Mine_____ 


Multimedia Authoring with Apple Media Tool. 


MultiWare Multimedia Music Clips (game section)......19 

Music Tracks (game section)..............20 


N 

Native PowerPack. 


.5 

NeoAccess.. 

: 

: 

: 

: 

i 

1 

; 

.*,.,***.„„43 


Neologic........ ........„. .13 

NetObjects Fusion Handbook ..... ....,.. 28 

Netscape Navigator 3.Q.. ........... 27 

Netscape Navigator Starter Kit for Macintosh ... .27 

Network Frontiers Bundle .......„,****„..... 23 

Newton Programmer's Guide tor Newton 2.0 ........ 3 

Newton Toolkit 1.6.......*..... 3 

Nextstep Devebpment Tools and Techniques ..... ..22 

Nextstep General Reference. ........ .,.22 

Nextstep Programming Interface Summary ....*,... 22 

Nextstep User Interface Gudetine$.....~ ........ 22 

Night Sky Interactive (game section)..,...,......19 

Ntsus Software.*............. 18 

NS BASIC 3.6 for the Newton with Visual Designer.,....10 

NS BASIC Corporation .....10 


Object Oriented Program Design ...... ,,,24 

Object-Oriented Fundamentals 1,1........*4 

Objective C - Object-Oriented Programming Techniques ... 24 

ObjectSet Mail SDK for Macintosh....*.11 

Onyx Technology...........14 

OOFILE Reporter Writer.........****41 


OpenDoc Programmer's Cookbook.. 
OpenDoc Programmer *s Guide . 

OpenGL for the Macintosh...,. 


22 
22 

.17 

Optimizing PowerPC Code: ........ 23 

Orchard Software............13 


Programming For The Newton ....... 

Programming with AppleTalk..... ... 

Providing Internet Services via the MacOS... 


-23 

.23 

,.27 


n q 

QC.... 

.14 

QUEO/M 3*0.*...... 

.._._..18 

QuickTime Deuel oner's Kit 2.0.... 


QuickTime VR 2*0 Authoring Tools Suite........4 


R 5 

r-lree Report Generator___ 

....... 13 

Rach Inc............ 

......„,„13 

ResEdit Ait Night Drier..... 

ResEdit Compters...... 

..... 22 

_____ ,22 

Roaster. *.. ....*.**.. 

.. 2 

Roaster Technologies, Inc.... 

Royal Software, Inc,...... 

..8 

...„.,12. 14 


11,16 
... ^12 

Screen Machine (game section).*,.,.. 

.. 20 

Script Debugger.,.... 


. 28 

Scripter 2*0...*..**. ****..**.***... 

12 

. 25 

SeriptGen Pro........ 

-j5 

**.,,40 

Scripting, additional products.... 

12 

..7, 25 

Seapine Software, Inc..... 

... ....16 

...,.25 

Sex; lias and Vidoo Games ... 

... 28 

,****4 

Smartcode Software. 

...... 11 

.19 

SoftPofish CD-ROM....... 



Special Edition Using CGi, 2nd Edition., 

SpeJfsweil Plus 2.0.4., 

STAZ Software... 

Step-Up Installer Pack., 

StepUp Software.. 

StoneTable 68K/PPC— 

StoneTabfet Publishing,.,.. 

Symantec Corporation. 

Symantec Visual Cafe. 

System 7.5 Technologies.. 


...27 

.45 

.15 

...15 

..13, 15 
****,**44 


.,14 

... 8,11 

11 

....£ 


TCP/IP Scripting Addition....* 

Teach Yourself Java for Macintosh in 21 Days.. 
Tenon Intersystems.... 

TestTrack-Bug Tracking the Macintosh Way*. 

The Elements of E-Matf Sfyte. 

Tog on Software Design ... 

Tools Plus libraries + framework.. 

Tricks of The Mac Game Programming Gums .. 

Trivia Warehouse 2000 (game section).. 


.12 

,.,..28 

12, 18 
16 
26 
23 
.10 
,29 
20 


UNI SOFTWARE PLUS.,.........14 


VIP-BASIC™: Visual Interactive Programming in BASIC, 
VIP-C™: Visual Interactive Programming in C 
Virtual Reality Programming with QuickTime VR Z0 
Virtual Tutor for QuickTime VR...... 

Programming with Prograph CPX ..... 

VMstar......... 

VOODOO 1.8. 

VText.. 



..25 

...17 

..14 

,.17 


Peri Quick Reference ....... ...24 

Personal MachTen for 68K Macs..,,,...,***„.*.*.***..,«*.. „**4 f 

Phyla™: Object-Oriented Database..........16 

Plctorius Inc,......„...„„........17 

Plan & Track™: Project Planning and Management,..™....46 

Planning and Managing Wfebsites . ....*,„„... ,....<27 

Power of Prcgraph CPX. .„*......... 25 

Power Box..,..............48 

PowerPC Programmer's Toolkit..,,... ....... 23 

Pro Fortran milHPW■ ■ H riifeiii«i ilia ********** m tti tAiiiiii.i f Hi ■ »!■»■#i«41 i fefeifttav i9 


Water's Edge Software. 
WaveConvert 

WAVES *, .* . 

Web Page Scripting Techniques,, 

Web Ware (game section). 
WindowScript ******* 

Wbrking Software.,,,,... 
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..,,26 

...20 

...42 

.,.,15 


Xpiain Corporation ..*„*........ .2 
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WebSiphon allows you to rapidly design custom 
server-side web applications by embedding 
an easy to learn, vet powerful scripting 
language directly into your HTML documents, 
WebSiphon also includes Verona, the only 
Macintosh flat-file database server written 
specifically for use on a web site. If you have 
ever felt restricted by other web site 
development products on the market,, then 
this is the tool for you. 


— PowerPC:” Native 

- Multi-threaded 

- Compiled Language 
- Caching 



demos 




WebSentinel replaces or supplements your 
web server's built-in security, allowing more 
flexibility and power to manage users and 
secure areas with a complete Macintosh user 
interface. Features include , " Diro u 
strings, custom “No Access'" 
realm, and full caching. WebSentinel's plug¬ 
in architecture allows you to integrate with 
your existing user data and security 
architectures. 


1016 mopac circle, suite 101 
austintx 78746 
phone 512.328.2288 
fax 512.328.2688 
info@purity.com 


.. J®, fljt i_ 

rn 'Inr hppjtfjSB Mclers/pmi 


a gg 

ICwWW* 




























t^e Codewrifer's best friend. 





Co d e til arrior. We're loyali 'lis're' tou g h and 

we're ready to take on Rhapsody* In ' TM i we 


helped you master writing code for the PowerP C T 1 


Now you're entering riew territory- Do it with 
development tools that are as --familiar as -your 
own backyard: the power full proven CodeUarrior IE 

Integrated Development Environmenti with hybrid 

** ■ * 

C + + /Ob jective C compilerls. You want Apple's new 
Operating System for symmetric multiprocessing 1 “ 
preemptive multitasking and protected memory. 

You want CodeUarrior IE for proven perfprmancei 
unrivaled customer service and dedicated sup- 
port- Take us home -‘we're loyali tough and 
completely housebroken. _ 

MarMall 


CodeWarrior 

Wo. r k t / aur. 4_ 


fA 


l.flDQ.222.250* 


your terrif 


o r 


metrowerks 


MacConnectio 

i.aaa.m-sas? w-i.ni 











